# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2025, 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

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.10\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-09-22 21:19+0000\n"

"PO-Revision-Date: 2025-09-22 15:56+0000\n"

"Last-Translator: python-doc bot, 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"

#: ../../c-api/conversion.rst:6

msgid "String conversion and formatting"

msgstr "Conversão e formação de strings"

#: ../../c-api/conversion.rst:8

msgid "Functions for number conversion and formatted string output."

msgstr "Funções para conversão de números e saída formatada de strings."

#: ../../c-api/conversion.rst:13

msgid ""

"Output not more than *size* bytes to *str* according to the format string "

"*format* and the extra arguments. See the Unix man page :manpage:"

"`snprintf(3)`."

msgstr ""

"Saída não superior a *size* bytes para *str* de acordo com a string de "

"formato *format* e os argumentos extras. Veja a página man do Unix :manpage:"

"`snprintf(3)`."

#: ../../c-api/conversion.rst:19

msgid ""

"Output not more than *size* bytes to *str* according to the format string "

"*format* and the variable argument list *va*. Unix man page :manpage:"

"`vsnprintf(3)`."

msgstr ""

"Saída não superior a *size* bytes para *str* de acordo com o string de "

"formato *format* e a variável argumento de lista *va*. Página man do Unix :"

"manpage:`vsnprintf(3)`."

#: ../../c-api/conversion.rst:23

msgid ""

":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C "

"library functions :c:func:`snprintf` and :c:func:`vsnprintf`. Their purpose "

"is to guarantee consistent behavior in corner cases, which the Standard C "

"functions do not."

msgstr ""

":c:func:`PyOS_snprintf` e :c:func:`PyOS_vsnprintf` envolvem as funções :c:"

"func:`snprintf` e :c:func:`vsnprintf` da biblioteca Standard C. Seu objetivo "

"é garantir um comportamento consistente em casos extremos, o que as funções "

"do Standard C não garantem."

#: ../../c-api/conversion.rst:28

msgid ""

"The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. "

"They never write more than *size* bytes (including the trailing ``'\\0'``) "

"into str. Both functions require that ``str != NULL``, ``size > 0``, "

"``format != NULL`` and ``size < INT_MAX``. Note that this means there is no "

"equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine "

"the necessary buffer size."

msgstr ""

"Os invólucros garantem que ``str[size-1]`` seja sempre ``'\\0'`` no retorno. "

"Eles nunca escrevem mais do que *size* bytes (incluindo o ``'\\0'`` ao "

"final) em str. Ambas as funções exigem que ``str != NULL``, ``size > 0``, "

"``format != NULL`` e ``size < INT_MAX``. Note que isso significa que não há "

"equivalente ao ``n = snprintf(NULL, 0, ...)`` do C99 que determinaria o "

"tamanho de buffer necessário."

#: ../../c-api/conversion.rst:34

msgid ""

"The return value (*rv*) for these functions should be interpreted as follows:"

msgstr ""

"O valor de retorno (*rv*) para essas funções deve ser interpretado da "

"seguinte forma:"

#: ../../c-api/conversion.rst:36

msgid ""

"When ``0 <= rv < size``, the output conversion was successful and *rv* "

"characters were written to *str* (excluding the trailing ``'\\0'`` byte at "

"``str[rv]``)."

msgstr ""

"Quando ``0 <= rv < size``, a conversão de saída foi bem-sucedida e os "

"caracteres de *rv* foram escritos em *str* (excluindo o ``'\\0'`` byte em "

"``str[rv]``)."

#: ../../c-api/conversion.rst:40

msgid ""

"When ``rv >= size``, the output conversion was truncated and a buffer with "

"``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is "

"``'\\0'`` in this case."

msgstr ""

"Quando ``rv >= size``, a conversão de saída foi truncada e um buffer com "

"``rv + 1`` bytes teria sido necessário para ter sucesso. ``str[size-1]`` é "

"``'\\0'`` neste caso."

#: ../../c-api/conversion.rst:44

msgid ""

"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in "

"this case too, but the rest of *str* is undefined. The exact cause of the "

"error depends on the underlying platform."

msgstr ""

"Quando ``rv < 0``, \"aconteceu algo de errado.\" ``str[size-1]`` é ``'\\0'`` "

"neste caso também, mas o resto de *str* é indefinido. A causa exata do erro "

"depende da plataforma subjacente."

#: ../../c-api/conversion.rst:49

msgid ""

"The following functions provide locale-independent string to number "

"conversions."

msgstr ""

"As funções a seguir fornecem strings independentes de localidade para "

"conversões de números."

#: ../../c-api/conversion.rst:53

msgid ""

"Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on "

"failure. The set of accepted strings corresponds to the set of strings "

"accepted by Python's :func:`float` constructor, except that ``s`` must not "

"have leading or trailing whitespace. The conversion is independent of the "

"current locale."

msgstr ""

"Converte uma string ``s`` em :c:expr:`double`, levantando uma exceção Python "

"em caso de falha. O conjunto de strings aceitas corresponde ao conjunto de "

"strings aceito pelo construtor :func:`float` do Python, exceto que ``s`` não "

"deve ter espaços em branco à esquerda ou à direita. A conversão é "

"independente da localidade atual."

#: ../../c-api/conversion.rst:59

msgid ""

"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:"

"`ValueError` and return ``-1.0`` if the string is not a valid representation "

"of a floating-point number."

msgstr ""

"Se ``endptr`` for ``NULL``, converte a string inteira. Levanta :exc:"

"`ValueError` e retorna ``-1.0`` se a string não for uma representação válida "

"de um número de ponto flutuante."

#: ../../c-api/conversion.rst:63

msgid ""

"If endptr is not ``NULL``, convert as much of the string as possible and set "

"``*endptr`` to point to the first unconverted character. If no initial "

"segment of the string is the valid representation of a floating-point "

"number, set ``*endptr`` to point to the beginning of the string, raise "

"ValueError, and return ``-1.0``."

msgstr ""

"Se endptr não for ``NULL``, converte o máximo possível da string e define "

"``*endptr`` para apontar para o primeiro caractere não convertido. Se nenhum "

"segmento inicial da string for a representação válida de um número de ponto "

"flutuante, define ``*endptr`` para apontar para o início da string, levanta "

"ValueError e retorna ``-1.0``."

#: ../../c-api/conversion.rst:70

msgid ""

"If ``s`` represents a value that is too large to store in a float (for "

"example, ``\"1e500\"`` is such a string on many platforms) then if "

"``overflow_exception`` is ``NULL`` return ``Py_HUGE_VAL`` (with an "

"appropriate sign) and don't set any exception. Otherwise, "

"``overflow_exception`` must point to a Python exception object; raise that "

"exception and return ``-1.0``. In both cases, set ``*endptr`` to point to "

"the first character after the converted value."

msgstr ""

"Se ``s`` representa um valor que é muito grande para armazenar em um ponto "

"flutuante (por exemplo, ``\"1e500\"`` é uma string assim em muitas "

"plataformas), então se ``overflow_exception`` for ``NULL`` retorna "

"``Py_HUGE_VAL`` (com um sinal apropriado) e não define nenhuma exceção. Caso "

"contrário, ``overflow_exception`` deve apontar para um objeto de exceção "

"Python; levanta essa exceção e retorna ``-1.0``. Em ambos os casos, define "

"``*endptr`` para apontar para o primeiro caractere após o valor convertido."

#: ../../c-api/conversion.rst:78

msgid ""

"If any other error occurs during the conversion (for example an out-of-"

"memory error), set the appropriate Python exception and return ``-1.0``."

msgstr ""

"Se qualquer outro erro ocorrer durante a conversão (por exemplo, um erro de "

"falta de memória), define a exceção Python apropriada e retorna ``-1.0``."

#: ../../c-api/conversion.rst:87

msgid ""

"Convert a :c:expr:`double` *val* to a string using supplied *format_code*, "

"*precision*, and *flags*."

msgstr ""

"Converte um *val* :c:expr:`double` para uma string usando *format_code*, "

"*precision* e *flags* fornecidos."

#: ../../c-api/conversion.rst:90

msgid ""

"*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "

"``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is "

"ignored. The ``'r'`` format code specifies the standard :func:`repr` format."

msgstr ""

"*format_code* deve ser um entre ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "

"``'G'`` ou ``'r'``. Para ``'r'``, a precisão *precision* fornecida deve ser "

"0 e é ignorada. O código de formato ``'r'`` especifica o formato padrão de :"

"func:`repr`."

#: ../../c-api/conversion.rst:95

msgid ""

"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, "

"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:"

msgstr ""

"*flags* pode ser zero ou mais de valores ``Py_DTSF_SIGN``, "

"``Py_DTSF_ADD_DOT_0`` ou ``Py_DTSF_ALT``, alternados por operador lógico OU:"

#: ../../c-api/conversion.rst:98

msgid ""

"``Py_DTSF_SIGN`` means to always precede the returned string with a sign "

"character, even if *val* is non-negative."

msgstr ""

"``Py_DTSF_SIGN`` significa sempre preceder a string retornada com um "

"caractere de sinal, mesmo se *val* não for negativo."

#: ../../c-api/conversion.rst:101

msgid ""

"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look "

"like an integer."

msgstr ""

"``Py_DTSF_ADD_DOT_0`` significa garantir que a string retornada não se "

"pareça com um inteiro."

#: ../../c-api/conversion.rst:104

msgid ""

"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the "

"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details."

msgstr ""

"``Py_DTSF_ALT`` significa aplicar regras de formatação \"alternativas\". "

"Veja a documentação para o especificador ``'#'`` de :c:func:`PyOS_snprintf` "

"para detalhes."

#: ../../c-api/conversion.rst:108

msgid ""

"If *ptype* is non-``NULL``, then the value it points to will be set to one "

"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying "

"that *val* is a finite number, an infinite number, or not a number, "

"respectively."

msgstr ""

"Se *type* não for ``NULL``, então o valor para o qual ele aponta será "

"definido como um dos ``Py_DTST_FINITE``, ``Py_DTST_INFINITE`` ou "

"``Py_DTST_NAN``, significando que *val* é um número finito, um número "

"infinito ou não um número, respectivamente."

#: ../../c-api/conversion.rst:112

msgid ""

"The return value is a pointer to *buffer* with the converted string or "

"``NULL`` if the conversion failed. The caller is responsible for freeing the "

"returned string by calling :c:func:`PyMem_Free`."

msgstr ""

"O valor de retorno é um ponteiro para *buffer* com a string convertida ou "

"``NULL`` se a conversão falhou. O chamador é responsável por liberar a "

"string retornada chamando :c:func:`PyMem_Free`."

#: ../../c-api/conversion.rst:121

msgid ""

"Case insensitive comparison of strings. The function works almost "

"identically to :c:func:`strcmp` except that it ignores the case."

msgstr ""

"Comparação de strings sem diferença entre maiúsculas e minúsculas. A função "

"funciona quase de forma idêntica a :c:func:`strcmp` exceto que ignora o caso."

#: ../../c-api/conversion.rst:127

msgid ""

"Case insensitive comparison of strings. The function works almost "

"identically to :c:func:`strncmp` except that it ignores the case."

msgstr ""

"Comparação de strings sem diferença entre maiúsculas e minúsculas. A função "

"funciona quase de forma idêntica a :c:func:`strncmp` exceto que ignora o "

"caso."