array.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2026, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# python-doc bot, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-03-27 15:43+0000\n"
"PO-Revision-Date: 2025-09-15 01:03+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
"teams/5390/pt_BR/)\n"
"Language: pt_BR\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
"1000000 == 0 ? 1 : 2;\n"

#: ../../library/array.rst:2
msgid ":mod:`!array` --- Efficient arrays of numeric values"
msgstr ":mod:`!array`--- Vetores eficientes de valores numéricos"

#: ../../library/array.rst:11
msgid ""
"This module defines an object type which can compactly represent an array of "
"basic values: characters, integers, floating-point numbers.  Arrays are "
"mutable :term:`sequence` types and behave very much like lists, except that "
"the type of objects stored in them is constrained.  The type is specified at "
"object creation time by using a :dfn:`type code`, which is a single "
"character.  The following type codes are defined:"
msgstr ""

#: ../../library/array.rst:19
msgid "Type code"
msgstr "Código de tipo"

#: ../../library/array.rst:19
msgid "C Type"
msgstr "Tipo em C"

#: ../../library/array.rst:19
msgid "Python Type"
msgstr "Tipo em Python"

#: ../../library/array.rst:19
msgid "Minimum size in bytes"
msgstr "Tamanho mínimo em bytes"

#: ../../library/array.rst:19
msgid "Notes"
msgstr "Notas"

#: ../../library/array.rst:21
msgid "``'b'``"
msgstr "``'b'``"

#: ../../library/array.rst:21
msgid "signed char"
msgstr "signed char"

#: ../../library/array.rst:21 ../../library/array.rst:23
#: ../../library/array.rst:29 ../../library/array.rst:31
#: ../../library/array.rst:33 ../../library/array.rst:35
#: ../../library/array.rst:37 ../../library/array.rst:39
#: ../../library/array.rst:41 ../../library/array.rst:43
msgid "int"
msgstr "int"

#: ../../library/array.rst:21 ../../library/array.rst:23
msgid "1"
msgstr "1"

#: ../../library/array.rst:23
msgid "``'B'``"
msgstr "``'B'``"

#: ../../library/array.rst:23
msgid "unsigned char"
msgstr "unsigned char"

#: ../../library/array.rst:25
msgid "``'u'``"
msgstr "``'u'``"

#: ../../library/array.rst:25
msgid "wchar_t"
msgstr "wchar_t"

#: ../../library/array.rst:25 ../../library/array.rst:27
msgid "Unicode character"
msgstr "Caractere unicode"

#: ../../library/array.rst:25 ../../library/array.rst:29
#: ../../library/array.rst:31 ../../library/array.rst:33
#: ../../library/array.rst:35
msgid "2"
msgstr "2"

#: ../../library/array.rst:25
msgid "\\(1)"
msgstr "\\(1)"

#: ../../library/array.rst:27
msgid "``'w'``"
msgstr "``'w'``"

#: ../../library/array.rst:27
msgid "Py_UCS4"
msgstr "Py_UCS4"

#: ../../library/array.rst:27 ../../library/array.rst:37
#: ../../library/array.rst:39 ../../library/array.rst:45
msgid "4"
msgstr "4"

#: ../../library/array.rst:27
msgid "\\(2)"
msgstr "\\(2)"

#: ../../library/array.rst:29
msgid "``'h'``"
msgstr "``'h'``"

#: ../../library/array.rst:29
msgid "signed short"
msgstr "signed short"

#: ../../library/array.rst:31
msgid "``'H'``"
msgstr "``'H'``"

#: ../../library/array.rst:31
msgid "unsigned short"
msgstr "unsigned short"

#: ../../library/array.rst:33
msgid "``'i'``"
msgstr "``'i'``"

#: ../../library/array.rst:33
msgid "signed int"
msgstr "signed int"

#: ../../library/array.rst:35
msgid "``'I'``"
msgstr "``'I'``"

#: ../../library/array.rst:35
msgid "unsigned int"
msgstr "unsigned int"

#: ../../library/array.rst:37
msgid "``'l'``"
msgstr "``'l'``"

#: ../../library/array.rst:37
msgid "signed long"
msgstr "signed long"

#: ../../library/array.rst:39
msgid "``'L'``"
msgstr "``'L'``"

#: ../../library/array.rst:39
msgid "unsigned long"
msgstr "unsigned long"

#: ../../library/array.rst:41
msgid "``'q'``"
msgstr "``'q'``"

#: ../../library/array.rst:41
msgid "signed long long"
msgstr "signed long long"

#: ../../library/array.rst:41 ../../library/array.rst:43
#: ../../library/array.rst:47
msgid "8"
msgstr "8"

#: ../../library/array.rst:43
msgid "``'Q'``"
msgstr "``'Q'``"

#: ../../library/array.rst:43
msgid "unsigned long long"
msgstr "unsigned long long"

#: ../../library/array.rst:45
msgid "``'f'``"
msgstr "``'f'``"

#: ../../library/array.rst:45 ../../library/array.rst:47
msgid "float"
msgstr "ponto flutuante"

#: ../../library/array.rst:47
msgid "``'d'``"
msgstr "``'d'``"

#: ../../library/array.rst:47
msgid "double"
msgstr "double"

#: ../../library/array.rst:50
msgid "Notes:"
msgstr "Notas:"

#: ../../library/array.rst:53
msgid "It can be 16 bits or 32 bits depending on the platform."
msgstr "Pode ser de 16 ou 32 bits dependendo da plataforma."

#: ../../library/array.rst:55
msgid ""
"``array('u')`` now uses :c:type:`wchar_t` as C type instead of deprecated "
"``Py_UNICODE``. This change doesn't affect its behavior because "
"``Py_UNICODE`` is alias of :c:type:`wchar_t` since Python 3.3."
msgstr ""
"``array('u')`` agora usa :c:type:`wchar_t` como tipo C no lugar do "
"descontinuado ``Py_UNICODE``. Essa mudança não afeta o comportamento pois "
"``Py_UNICODE`` é um apelido para :c:type:`wchar_t` desde Python 3.3."

#: ../../library/array.rst:60
msgid "Please migrate to ``'w'`` typecode."
msgstr "Por favor, migre para o código de tipo ``'w'``."

#: ../../library/array.rst:67
msgid ""
"The actual representation of values is determined by the machine "
"architecture (strictly speaking, by the C implementation).  The actual size "
"can be accessed through the :attr:`array.itemsize` attribute."
msgstr ""
"A representação dos valores é definida pela arquitetura da máquina, mais "
"especificamente da implementação do C. O tamanho real pode ser acessado pelo "
"atributo :attr:`array.itemsize`."

#: ../../library/array.rst:71
msgid "The module defines the following item:"
msgstr "O módulo define o seguinte item:"

#: ../../library/array.rst:76
msgid "A string with all available type codes."
msgstr "String com todos os códigos de tipo disponíveis."

#: ../../library/array.rst:79
msgid "The module defines the following type:"
msgstr "O módulo define o seguinte tipo:"

#: ../../library/array.rst:84
msgid ""
"A new array whose items are restricted by *typecode*, and initialized from "
"the optional *initializer* value, which must be a :class:`bytes` or :class:"
"`bytearray` object, a Unicode string, or iterable over elements of the "
"appropriate type."
msgstr ""
"Um novo vetor cujos itens são restritos por *typecode* e inicializados a "
"partir do valor opcional *initializer*, que deve ser um objeto :class:"
"`bytes` ou :class:`bytearray`, uma string Unicode ou iterável sobre "
"elementos do tipo apropriado."

#: ../../library/array.rst:89
msgid ""
"If given a :class:`bytes` or :class:`bytearray` object, the initializer is "
"passed to the new array's :meth:`frombytes` method; if given a Unicode "
"string, the initializer is passed to the :meth:`fromunicode` method; "
"otherwise, the initializer's iterator is passed to the :meth:`extend` method "
"to add initial items to the array."
msgstr ""
"Se for fornecido um objeto :class:`bytes` ou :class:`bytearray`, o "
"inicializador é passado para o método :meth:`frombytes` do novo vetor; se "
"for fornecida uma string Unicode, o inicializador é passado para o método :"
"meth:`fromunicode`; caso contrário, o iterador do inicializador é passado "
"para o método :meth:`extend` para adicionar itens iniciais ao vetor."

#: ../../library/array.rst:96
msgid ""
"Array objects support the ordinary :ref:`mutable <typesseq-mutable>` :term:"
"`sequence` operations of indexing, slicing, concatenation, and "
"multiplication.  When using slice assignment, the assigned value must be an "
"array object with the same type code; in all other cases, :exc:`TypeError` "
"is raised. Array objects also implement the buffer interface, and may be "
"used wherever :term:`bytes-like objects <bytes-like object>` are supported."
msgstr ""

#: ../../library/array.rst:102
msgid ""
"Raises an :ref:`auditing event <auditing>` ``array.__new__`` with arguments "
"``typecode``, ``initializer``."
msgstr ""
"Levanta um :ref:`evento de auditoria <auditing>` ``array.__new__`` com os "
"argumentos ``typecode``, ``initializer``."

#: ../../library/array.rst:107
msgid "The typecode character used to create the array."
msgstr "O caractere de código de tipo usado para criar o vetor."

#: ../../library/array.rst:112
msgid "The length in bytes of one array item in the internal representation."
msgstr "O tamanho em bytes de um item do vetor em representação interna."

#: ../../library/array.rst:117
msgid "Append a new item with the specified value to the end of the array."
msgstr ""

#: ../../library/array.rst:122
msgid ""
"Return a tuple ``(address, length)`` giving the current memory address and "
"the length in elements of the buffer used to hold array's contents.  The "
"size of the memory buffer in bytes can be computed as ``array.buffer_info()"
"[1] * array.itemsize``.  This is occasionally useful when working with low-"
"level (and inherently unsafe) I/O interfaces that require memory addresses, "
"such as certain :c:func:`!ioctl` operations.  The returned numbers are valid "
"as long as the array exists and no length-changing operations are applied to "
"it."
msgstr ""
"Retorna uma tupla ``(address, length)`` com o endereço corrente da memória e "
"o tamanho em elementos do buffer usado para armazenar conteúdos do vetor. O "
"tamanho do buffer da memória em bytes pode ser computado como ``array."
"buffer_info()[1] * array.itemsize``. Isso é ocasionalmente útil quando se "
"está trabalhando com interfaces I/O de baixo nível (inerentemente inseguras) "
"que precisam de endereços de memória, como algumas operações :c:func:`!"
"ioctl`. Os números retornados são válidos enquanto o vetor existir e nenhuma "
"operação de alteração de tamanho for aplicada a ele."

#: ../../library/array.rst:132
msgid ""
"When using array objects from code written in C or C++ (the only way to "
"effectively make use of this information), it makes more sense to use the "
"buffer interface supported by array objects.  This method is maintained for "
"backward compatibility and should be avoided in new code.  The buffer "
"interface is documented in :ref:`bufferobjects`."
msgstr ""
"Quando se está usando vetores de código escrito em C ou C++ (o único jeito "
"efetivo de usar essa informação), faz mais sentido usar a interface do "
"buffer suportada pelos vetores. Esse método é mantido para "
"retrocompatibilidade e deve ser evitado em código novo. A interface de "
"buffers está documentada em :ref:`bufferobjects`."

#: ../../library/array.rst:141
msgid ""
"\"Byteswap\" all items of the array.  This is only supported for values "
"which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:"
"`RuntimeError` is raised.  It is useful when reading data from a file "
"written on a machine with a different byte order."
msgstr ""
"\"Byteswap\" todos os itens do vetor. Isso é somente suportado para valores "
"de 1, 2, 4 ou 8 bytes de tamanho; para outros tipos de valores é levantada :"
"exc:`RuntimeError`. Isso é útil quando estamos lendo dados de um arquivo "
"para serem escritos em um arquivo de outra máquina de ordem de bytes "
"diferente."

#: ../../library/array.rst:149
msgid "Return the number of occurrences of *value* in the array."
msgstr ""

#: ../../library/array.rst:154
msgid ""
"Append items from *iterable* to the end of the array.  If *iterable* is "
"another array, it must have *exactly* the same type code; if not, :exc:"
"`TypeError` will be raised.  If *iterable* is not an array, it must be "
"iterable and its elements must be the right type to be appended to the array."
msgstr ""
"Acrescenta os itens de *iterable* ao final do vetor. Se *iterable* for outro "
"vetor, ele deve ter *exatamente* o mesmo código de tipo; senão, ocorrerá "
"uma :exc:`TypeError`. Se *iterable* não for um vetor, ele deve ser iterável "
"e seus elementos devem ser do tipo correto para ser acrescentado ao vetor."

#: ../../library/array.rst:162
msgid ""
"Appends items from the :term:`bytes-like object`, interpreting its content "
"as an array of machine values (as if it had been read from a file using the :"
"meth:`fromfile` method)."
msgstr ""
"Adiciona itens do :term:`objeto bytes ou similar`, interpretando seu "
"conteúdo como um vetor de valores de máquina (como se tivesse sido lido de "
"um arquivo usando o método :meth:`fromfile`)."

#: ../../library/array.rst:166
msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity."
msgstr ""
":meth:`!fromstring` foi renomeado para :meth:`frombytes` para maior clareza."

#: ../../library/array.rst:172
msgid ""
"Read *n* items (as machine values) from the :term:`file object` *f* and "
"append them to the end of the array.  If less than *n* items are available, :"
"exc:`EOFError` is raised, but the items that were available are still "
"inserted into the array."
msgstr ""
"Lê *n* itens (como valores de máquinas) do :term:`objeto arquivo <file "
"object>` *f* e adiciona-os ao fim do vetor. Se estão disponíveis menos de "
"*n* itens, :exc:`EOFError` é levantada, mas os itens disponíveis ainda são "
"inseridos ao final do vetor."

#: ../../library/array.rst:180
msgid ""
"Append items from the list.  This is equivalent to ``for x in list: a."
"append(x)`` except that if there is a type error, the array is unchanged."
msgstr ""
"Adiciona itens de *list*.  Isso é equivalente a ``for x in list: a."
"append(x)`` exceto que se ocorrer um erro de tipo, o vetor não é alterado."

#: ../../library/array.rst:186
msgid ""
"Extends this array with data from the given Unicode string. The array must "
"have type code ``'u'`` or ``'w'``; otherwise a :exc:`ValueError` is raised. "
"Use ``array.frombytes(unicodestring.encode(enc))`` to append Unicode data to "
"an array of some other type."
msgstr ""
"Estende este vetor com dados da string Unicode fornecida. O vetor deve ter o "
"código de tipo ``'u'`` ou ``'w'``; caso contrário, uma :exc:`ValueError` é "
"levantada. Use ``array.frombytes(unicodestring.encode(enc))`` para anexar "
"dados Unicode a um vetor de algum outro tipo."

#: ../../library/array.rst:194
msgid ""
"Return the smallest *i* such that *i* is the index of the first occurrence "
"of *value* in the array.  The optional arguments *start* and *stop* can be "
"specified to search for *value* within a subsection of the array.  Raise :"
"exc:`ValueError` if *value* is not found."
msgstr ""

#: ../../library/array.rst:199
msgid "Added optional *start* and *stop* parameters."
msgstr "Adicionados os parâmetros opcionais *start e *stop*."

#: ../../library/array.rst:205
msgid ""
"Insert a new item *value* in the array before position *index*. Negative "
"values are treated as being relative to the end of the array."
msgstr ""

#: ../../library/array.rst:211
msgid ""
"Removes the item with the index *i* from the array and returns it. The "
"optional argument defaults to ``-1``, so that by default the last item is "
"removed and returned."
msgstr ""
"Remove o item com o índice *i* do vetor e retorna este item. O valor padrão "
"do argumento opcional é ``-1``, assim por padrão o último item é removido e "
"retornado."

#: ../../library/array.rst:218
msgid "Remove the first occurrence of *value* from the array."
msgstr ""

#: ../../library/array.rst:223
msgid "Remove all elements from the array."
msgstr "Remove todos os elementos do vetor."

#: ../../library/array.rst:230
msgid "Reverse the order of the items in the array."
msgstr "Inverte a ordem dos itens no vetor."

#: ../../library/array.rst:235
msgid ""
"Convert the array to an array of machine values and return the bytes "
"representation (the same sequence of bytes that would be written to a file "
"by the :meth:`tofile` method.)"
msgstr ""
"Devolve os itens do vetor como um vetor de valores de máquina com a "
"representação em bytes (a mesma sequência de bytes que seria escrita pelo "
"método :meth:`tofile`.)"

#: ../../library/array.rst:239
msgid ":meth:`!tostring` is renamed to :meth:`tobytes` for clarity."
msgstr ":meth:`!tostring` foi nomeado para :meth:`tobytes` para maior clareza."

#: ../../library/array.rst:245
msgid "Write all items (as machine values) to the :term:`file object` *f*."
msgstr ""
"Escreve todos os itens (como valores de máquinas) para o :term:`objeto "
"arquivo <file object>` *f*."

#: ../../library/array.rst:250
msgid "Convert the array to an ordinary list with the same items."
msgstr "Devolve os itens do vetor como uma lista comum."

#: ../../library/array.rst:255
msgid ""
"Convert the array to a Unicode string.  The array must have a type ``'u'`` "
"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()."
"decode(enc)`` to obtain a Unicode string from an array of some other type."
msgstr ""
"Devolve os itens do vetor como uma string Unicode. O vetor deve ser do tipo "
"``'u'`` ou ``'w'``; caso contrário :exc:`ValueError` é levantada. Use "
"``array.tobytes().decode(enc)`` para obter uma string Unicode de um vetor de "
"outros tipos."

#: ../../library/array.rst:260
msgid ""
"The string representation of array objects has the form ``array(typecode, "
"initializer)``. The *initializer* is omitted if the array is empty, "
"otherwise it is a Unicode string if the *typecode* is ``'u'`` or ``'w'``, "
"otherwise it is a list of numbers. The string representation is guaranteed "
"to be able to be converted back to an array with the same type and value "
"using :func:`eval`, so long as the :class:`~array.array` class has been "
"imported using ``from array import array``. Variables ``inf`` and ``nan`` "
"must also be defined if it contains corresponding floating-point values. "
"Examples::"
msgstr ""
"A representação em string de objetos vetor tem o formato ``array(typecode, "
"initializer)``. O *initializer* é omitido se o vetor estiver vazio; caso "
"contrário, é uma string Unicode se o *typecode* for ``'u'`` ou ``'w'``; caso "
"contrário, é uma lista de números. A representação em string pode ser "
"convertida novamente para um array com o mesmo tipo e valor usando :func:"
"`eval`, desde que a classe :class:`~array.array` tenha sido importada usando "
"``from array import array``. As variáveis ``inf`` e ``nan`` também devem ser "
"definidas se contiverem valores de ponto flutuante correspondentes. Exemplos:"

#: ../../library/array.rst:272
msgid ""
"array('l')\n"
"array('w', 'hello \\u2641')\n"
"array('l', [1, 2, 3, 4, 5])\n"
"array('d', [1.0, 2.0, 3.14, -inf, nan])"
msgstr ""
"array('l')\n"
"array('w', 'hello \\u2641')\n"
"array('l', [1, 2, 3, 4, 5])\n"
"array('d', [1.0, 2.0, 3.14, -inf, nan])"

#: ../../library/array.rst:280
msgid "Module :mod:`struct`"
msgstr "Módulo :mod:`struct`"

#: ../../library/array.rst:281
msgid "Packing and unpacking of heterogeneous binary data."
msgstr "Empacotamento e desempacotamento de dados binários heterogêneos."

#: ../../library/array.rst:283
msgid "`NumPy <https://numpy.org/>`_"
msgstr "`NumPy <https://numpy.org/>`_"

#: ../../library/array.rst:284
msgid "The NumPy package defines another array type."
msgstr "O pacote NumPy define outro tipo de vetor."

#: ../../library/array.rst:7
msgid "arrays"
msgstr "vetores"