Функция bytearray( ) в Python

Функция bytearray в Python используется для создания изменяемой последовательности байт. Эта функция позволяет работать с последовательностями байт, предоставляя возможности для их изменения и манипуляции. В этой статье мы рассмотрим, как использовать функцию bytearray, ее параметры, примеры использования и основные возможности.

Синтаксис

bytearray([source[, encoding[, errors]]])

Аргументы

• source: (необязательный) Начальный источник данных для создания bytearray. Это может быть строка, байтовый объект, список целых чисел, диапазон (range), другой объект bytearray или объект, реализующий буферный интерфейс.
• encoding: (необязательный) Строка, определяющая кодировку, используемую для преобразования строки в байты. Используется только если source является строкой.
• errors: (необязательный) Строка, определяющая, как обрабатывать ошибки кодирования. Используется только если source является строкой.

Примеры использования

Пример 1: Создание bytearray из строки

data = "Hello, World!"
byte_data = bytearray(data, "utf-8")
print(byte_data)
# Вывод: bytearray(b'Hello, World!')

Пример 2: Создание bytearray из байтового объекта

byte_data = bytearray(b"Hello, World!")
print(byte_data)
# Вывод: bytearray(b'Hello, World!')

Пример 3: Создание bytearray из списка целых чисел

byte_data = bytearray([72, 101, 108, 108, 111])
print(byte_data)
# Вывод: bytearray(b'Hello')

Пример 4: Создание пустого bytearray

byte_data = bytearray()
print(byte_data)
# Вывод: bytearray(b'')

Основные возможности

Изменение элементов bytearray

Одним из ключевых преимуществ bytearray перед неизменяемым типом bytes является возможность изменения элементов.

byte_data = bytearray(b"Hello")
byte_data[0] = 104  # Замена 'H' на 'h'
print(byte_data)
# Вывод: bytearray(b'hello')

Добавление и удаление элементов

Вы можете добавлять и удалять элементы в bytearray, как в списке.

byte_data = bytearray(b"Hello")
byte_data.append(33)  # Добавление '!' (код ASCII 33)
print(byte_data)
# Вывод: bytearray(b'Hello!')

byte_data.pop()
print(byte_data)
# Вывод: bytearray(b'Hello')

Конкатенация и повторение

bytearray поддерживает операции конкатенации и повторения.

byte_data1 = bytearray(b"Hello, ")
byte_data2 = bytearray(b"World!")
combined = byte_data1 + byte_data2
print(combined)
# Вывод: bytearray(b'Hello, World!')

repeated = byte_data1 * 3
print(repeated)
# Вывод: bytearray(b'Hello, Hello, Hello, ')

Параметры encoding и errors

Использование параметра encoding

Параметр encoding используется для указания кодировки, когда исходным источником данных является строка.

data = "Привет, мир!"
byte_data = bytearray(data, "utf-8")
print(byte_data)
# Вывод: bytearray(b'\xd0\x9f\xd1\x80\xd0\xb8\xd0\xb2\xd0\xb5\xd1\x82, \xd0\xbc\xd0\xb8\xd1\x80!')

Использование параметра errors

Параметр errors определяет, как обрабатывать ошибки кодирования. Доступные значения: strict (по умолчанию), ignore, replace, xmlcharrefreplace, backslashreplace, namereplace.

strict (по умолчанию)

Этот режим вызывает ошибку UnicodeEncodeError, если строка содержит символы, которые не могут быть закодированы в указанной кодировке.

data = "Привет, мир!"
try:
    byte_data = bytearray(data, "ascii", errors="strict")
except UnicodeEncodeError as e:
    print("Ошибка кодирования:", e)
# Вывод: Ошибка кодирования: 'ascii' codec can't encode characters in position 0-5: ordinal not in range(128)

ignore

В этом режиме символы, которые не могут быть закодированы, просто игнорируются и пропускаются.

data = "Привет, мир!"
byte_data = bytearray(data, "ascii", errors="ignore")
print(byte_data)
# Вывод: bytearray(b', !')

replace

Этот режим заменяет символы, которые не могут быть закодированы, знаком вопроса ?

data = "Привет, мир!"
byte_data = bytearray(data, "ascii", errors="replace")
print(byte_data)
# Вывод: bytearray(b'??????, ???!')

xmlcharrefreplace

В этом режиме символы, которые не могут быть закодированы, заменяются XML-ссылками на символы.

data = "Привет, мир!"
byte_data = bytearray(data, "ascii", errors="xmlcharrefreplace")
print(byte_data)
# Вывод: bytearray(b'Привет, мир!')

backslashreplace

Этот режим заменяет символы, которые не могут быть закодированы, escape-последовательностями вида \uXXXXдля символов вне ASCII диапазона.

data = "Привет, мир!"
byte_data = bytearray(data, "ascii", errors="backslashreplace")
print(byte_data)
# Вывод: bytearray(b'\\u041f\\u0440\\u0438\\u0432\\u0435\\u0442, \\u043c\\u0438\\u0440!')

namereplace

Этот режим заменяет символы, которые не могут быть закодированы, именованными escape-последовательностями вида \N{CHARACTER NAME}.

data = "Привет, мир!"
byte_data = bytearray(data, "ascii", errors="namereplace")
print(byte_data)
# Вывод: bytearray(b'\\N{CYRILLIC CAPITAL LETTER PE}\\N{CYRILLIC SMALL LETTER ER}\\N{CYRILLIC SMALL LETTER I}\\N{CYRILLIC SMALL LETTER VE}\\N{CYRILLIC SMALL LETTER IE}\\N{CYRILLIC SMALL LETTER TE}, \\N{CYRILLIC SMALL LETTER EM}\\N{CYRILLIC SMALL LETTER I}\\N{CYRILLIC SMALL LETTER ER}!')