bytearray() Sequência de bytes mutável
Última atualização: 2026-09-22
bytearray() Sequência de bytes mutável
bytearray() retorna um array de bytes mutável, cujos elementos são inteiros de 0 a 255.
| Categoria | Funções internas |
|---|---|
| Tipo | Função interna |
| Versão do Python | all |
📝 Sintaxe
bytearray([source[, encoding]]]])⚙️ Parâmetros
| source Opcional | Optional: an int (length), string, iterable of ints, or bytes-like object.（Padrão：None） |
|---|---|
| encoding Opcional | Encoding name used when source is a str, e.g. 'utf-8'.（Padrão：None） |
| errors Opcional | Error-handling scheme for encoding, e.g. 'strict' / 'ignore'.（Padrão：None） |
Retorno：bytearray. A mutable byte array whose elements are ints 0-255.
💥 Exceções
TypeError— Raised when source has an unsupported type.ValueError— Raised when an element is outside 0-255 or the encoding is invalid.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
bytearray(b'Hello')🏷️ Funções internas relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQual é a diferença entre bytearray e bytes?
Abytearray é mutável (pode alterar elementos, fazer append, atribuir fatias); bytes é imutável; os elementos de ambos são inteiros de 0 a 255.
QPor que é obrigatório passar encoding ao criar bytearray a partir de uma string?
AUma string é feita de caracteres, não de bytes; é preciso especificar uma codificação (ex.: 'utf-8') para convertê-la em bytes. bytearray('中文') sem encoding levanta TypeError.
QQual é o tipo dos elementos de bytearray?
AOs elementos são inteiros de 0 a 255, ex.: bytearray(b'hello')[0] retorna 104, não 'h'; use chr() para voltar a caractere.
QOs elementos podem ultrapassar 0-255?
ANão. Atribuir a um elemento um valor fora do intervalo (ex.: ba[0] = 256) levanta ValueError.
