array – efficient arrays of numeric values¶

This module defines an object type which can compactly represent an array ofbasic values: characters, integers, floating point numbers. Arrays são sequencetipos e se comportam muito como listas, exceto que o tipo de objetos armazenados neles é restringido. O tipo é especificado no tempo de criação do objeto usando o código atype, que é um único caractere., São definidos os seguintes códigos de tipo:

notas:

1. pode ser de 16 bits ou 32 bits, dependendo da plataforma.

   Alterado na versão 3.9: array('u') agora usa wchar_t C em vez do tipo de obsoletoPy_UNICODE. Esta mudança não afeta o seu comportamento porquePy_UNICODE é também conhecido por wchar_t desde o Python 3.3.

   depreciado desde a versão 3.3, será removido na versão 4.0.,

a representação real dos valores é determinada pela Arquitectura da máquina(estritamente falando, pela implementação C). O tamanho real pode ser acessado através do atributo itemsize.

O módulo define do seguinte tipo:

classearray.array(typecode) n

Uma nova matriz cujos itens estão restritos por typecode, e initializedfrom opcional inicializador de valor, que deve ser uma lista, abytes como objeto, ou iterable sobre elementos de theappropriate tipo.,

Se for dada uma lista ou string, o inicializador é passado para a nova matrizfromlist() frombytes(), ou fromunicode() método (veja abaixo)para adicionar inicial de itens para a matriz. Caso contrário, o inicializador iterável é colocado no método extend().

Gera um evento de auditoria array.__new__ com argumentos typecode initializer.

array.typecodes¶

a string with all available type codes.,

Array objects support the ordinary sequence operations of indexing, slicing,concatenation, and multiplication. Ao usar a atribuição de fatia, o valor atribuído deve ser um objeto array com o mesmo tipo de código; em todos os outros casos,TypeError é elevado. Os objetos Array também implementam a interface buffer, e podem ser usados em qualquer lugar onde objetos do tipo bytes são suportados.

também são suportados os seguintes itens e métodos de dados:

array.typecode¶

o carácter Tipográfico utilizado para criar a matriz.,

array.itemsize¶

o comprimento em bytes de um item array na representação interna.

array.append(x)¶

adicione um novo item com o valor x ao fim da lista.

array.buffer_info()¶

Return a tuple (address, length) giving the current memory address and thelength in elements of the buffer used to hold array’s contents. The size of thememory buffer in bytes can be computed as array.buffer_info() *array.itemsize., Isto é ocasionalmente útil quando se trabalha com interfaces I/O de baixo nível (e, consequentemente, inseguras) que requerem endereços de memória, tais como certas operaçõesioctl(). Os números retornados são válidos desde que as listas e nenhuma operação de mudança de comprimento sejam aplicadas a ele.

array.byteswap() n

“Byteswap” todos os itens da matriz. Isto só é suportado para valores que são1, 2, 4 ou 8 bytes em tamanho; para outros tipos de valores, RuntimeError israised. É útil ao ler dados de um arquivo escrito em uma máquina com ordem de byte diferente.

array.count(x)¶

Return the number of occurrence of x in the array.,

array.extend(iterável)¶

adicione itens do iterable ao fim da lista. Se iterable for outro array, ele deve ter exatamente o mesmo tipo de código; se não, TypeError será levantado. Se iterable não é um array, ele deve ser iterável e seus Elements devem ser o tipo certo a ser adicionado ao array.

array.frombytes(s)¶

Acrescenta itens da cadeia, a interpretação de seqüência de caracteres como uma matriz de machinevalues (como se ele tivesse sido lido a partir de um arquivo usando o fromfile() método).,

array.fromfile(f, n)

Leia os itens n (Como valores da máquina) do objeto de arquivo f e apêndice até o final da matriz. Se menos de n itens estão disponíveis,EOFError é elevado, mas os itens que estavam disponíveis são stillinserted para a matriz. f deve ser um objeto de arquivo embutido; somethingelse com um id

método não serve.,array.fromlist(lista)¶

Acrescentar itens da lista. Isto é equivalente a for x in list:a.append(x) exceto que se houver um erro de tipo, a matriz é inalterada.

array.fromunicode(S)¶

estende esta matriz com dados da cadeia unicode dada. The array mustbe a type 'u' array; otherwise a ValueError is raised. Usearray.frombytes(unicodestring.encode(enc)) para adicionar dados Unicode para anarray de algum outro tipo.,

array.index(x)¶

Return the smallest i such that i is the index of the first occurrence OFX in the array.

array.insert(i, x)¶

inserir um novo item com valor x na matriz antes da posição I. Os valores negativos são tratados como sendo relativos ao fim da matriz.

array.pop()¶

Remove o item com o índice i de um array e retorna., O optionalargument é por omissão -1, de modo que por padrão o último item é removido e revertido.

array.remove(x)¶

Remove a primeira ocorrência de x da matriz.

array.()¶

inverte a ordem dos itens na matriz.

array.tobytes()¶

Converter a matriz a uma matriz de máquina valores e devolver o bytesrepresentation (a mesma seqüência de bytes que deve ser escrito para um arquivo pela tofile() método.,)

array.tofile(f) n

Escrever todos os itens (como máquina de valores) para o objeto de arquivo f.

array.tolist()¶

Converter a matriz comuns lista com os mesmos itens.

array.tounicode()¶

Convert the array to a unicode string. The array must be a type 'u' array;otherwise a ValueError is raised., Use array.tobytes().decode(enc) toobtain a unicode string from an array of some other type.

Quando um objeto array é impresso ou convertido para uma cadeia de caracteres, ele é representado comoarray(typecode, initializer). O inicializador é omitido se o array estiver vazio, caso contrário é uma cadeia se o typecode é 'u', caso contrário é uma lista de números. A seqüência de caracteres é garantido de ser capaz de ser convertido de volta para anarray com o mesmo tipo e valor usando eval(), comoarray classe foi importado usando from array import array.,Exemplos:

array('l')array('u', 'hello \u2641')array('l', )array('d', )