logo

bytearray(source=b'')

class bytearray(source, encoding)

class bytearray(source, encoding, errors)

Функция bytearray() возвращает объект bytearray, который представляет собой массив заданных байтов.

Параметры

Функция bytearray() принимает три необязательных параметра:

  • source (Необязательно) — источник для инициализации массива байтов.
  • encoding (необязательно) — если источником является строка, кодировка строки.
  • errors (необязательно) — если источником является строка, действие, предпринимаемое при сбое преобразования кодировки.

Возвращаемое значение

Возвращает массив байт. Тип bytearray — это изменяемая последовательность целых чисел в диапазоне 0 ≤ X < 256. Параметр source можно использовать для начальной инициализации массива:

  • Если source является строкой, вы также должны указать кодировку encoding и опционально errors
  • Если source является целым числом, массив будет иметь размер source и инициализирован байтами со значением 0
  • Если source является объектом, то он должен поддерживать интерфейс буфера. Для инициализации массива байт будет использован буфер, предназначенный для чтения.
  • Если source является итерируемым объектом, его элементами должны быть целыми числами в диапазоне 0 ≤ X < 256. Этими числами и будет инициализирован массив.
  • Если source не передан, вернет пустой bytearray

Примеры

bytearray('Привет, Python!', 'utf-8')
# bytearray(b'\xd0\x9f\xd1\x80\xd0\xb8\xd0\xb2\xd0\xb5\xd1\x82, Python!')
bytearray(5)
# bytearray(b'\x00\x00\x00\x00\x00')
bytearray([1, 2, 3])
# bytearray(b'\x01\x02\x03')