# 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.10\n"

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

"POT-Creation-Date: 2026-03-30 02:17+0000\n"

"PO-Revision-Date: 2025-09-22 15:57+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"

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

msgid "Initialization, Finalization, and Threads"

msgstr "Inicialização, finalização e threads"

#: ../../c-api/init.rst:10

msgid "See also :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

"Consulte também :ref:`Configuração de Inicialização do Python <init-config>`."

#: ../../c-api/init.rst:15

msgid "Before Python Initialization"

msgstr "Antes da inicialização do Python"

#: ../../c-api/init.rst:17

msgid ""

"In an application embedding Python, the :c:func:`Py_Initialize` function "

"must be called before using any other Python/C API functions; with the "

"exception of a few functions and the :ref:`global configuration variables "

"<global-conf-vars>`."

msgstr ""

"Em uma aplicação que incorpora Python, a função :c:func:`Py_Initialize` deve "

"ser chamada antes de usar qualquer outra função da API Python/C; com exceção "

"de algumas funções e as :ref:`variáveis globais de configuração <global-conf-"

"vars>`."

#: ../../c-api/init.rst:22

msgid ""

"The following functions can be safely called before Python is initialized:"

msgstr ""

"As seguintes funções podem ser seguramente chamadas antes da inicialização "

"do Python."

#: ../../c-api/init.rst:24

msgid "Configuration functions:"

msgstr "Funções de configuração"

#: ../../c-api/init.rst:26

msgid ":c:func:`PyImport_AppendInittab`"

msgstr ":c:func:`PyImport_AppendInittab`"

#: ../../c-api/init.rst:27

msgid ":c:func:`PyImport_ExtendInittab`"

msgstr ":c:func:`PyImport_ExtendInittab`"

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

msgid ":c:func:`PyInitFrozenExtensions`"

msgstr ":c:func:`PyInitFrozenExtensions`"

#: ../../c-api/init.rst:29

msgid ":c:func:`PyMem_SetAllocator`"

msgstr ":c:func:`PyMem_SetAllocator`"

#: ../../c-api/init.rst:30

msgid ":c:func:`PyMem_SetupDebugHooks`"

msgstr ":c:func:`PyMem_SetupDebugHooks`"

#: ../../c-api/init.rst:31

msgid ":c:func:`PyObject_SetArenaAllocator`"

msgstr ":c:func:`PyObject_SetArenaAllocator`"

#: ../../c-api/init.rst:32

msgid ":c:func:`Py_SetPath`"

msgstr ":c:func:`Py_SetPath`"

#: ../../c-api/init.rst:33

msgid ":c:func:`Py_SetProgramName`"

msgstr ":c:func:`Py_SetProgramName`"

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

msgid ":c:func:`Py_SetPythonHome`"

msgstr ":c:func:`Py_SetPythonHome`"

#: ../../c-api/init.rst:35

msgid ":c:func:`Py_SetStandardStreamEncoding`"

msgstr ":c:func:`Py_SetStandardStreamEncoding`"

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

msgid ":c:func:`PySys_AddWarnOption`"

msgstr ":c:func:`PySys_AddWarnOption`"

#: ../../c-api/init.rst:37

msgid ":c:func:`PySys_AddXOption`"

msgstr ":c:func:`PySys_AddXOption`"

#: ../../c-api/init.rst:38

msgid ":c:func:`PySys_ResetWarnOptions`"

msgstr ":c:func:`PySys_ResetWarnOptions`"

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

msgid "Informative functions:"

msgstr "Funções informativas:"

#: ../../c-api/init.rst:42

msgid ":c:func:`Py_IsInitialized`"

msgstr ":c:func:`Py_IsInitialized`"

#: ../../c-api/init.rst:43

msgid ":c:func:`PyMem_GetAllocator`"

msgstr ":c:func:`PyMem_GetAllocator`"

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

msgid ":c:func:`PyObject_GetArenaAllocator`"

msgstr ":c:func:`PyObject_GetArenaAllocator`"

#: ../../c-api/init.rst:45

msgid ":c:func:`Py_GetBuildInfo`"

msgstr ":c:func:`Py_GetBuildInfo`"

#: ../../c-api/init.rst:46

msgid ":c:func:`Py_GetCompiler`"

msgstr ":c:func:`Py_GetCompiler`"

#: ../../c-api/init.rst:47

msgid ":c:func:`Py_GetCopyright`"

msgstr ":c:func:`Py_GetCopyright`"

#: ../../c-api/init.rst:48

msgid ":c:func:`Py_GetPlatform`"

msgstr ":c:func:`Py_GetPlatform`"

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

msgid ":c:func:`Py_GetVersion`"

msgstr ":c:func:`Py_GetVersion`"

#: ../../c-api/init.rst:51

msgid "Utilities:"

msgstr "Utilitários:"

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

msgid ":c:func:`Py_DecodeLocale`"

msgstr ":c:func:`Py_DecodeLocale`"

#: ../../c-api/init.rst:55

msgid "Memory allocators:"

msgstr "Alocadores de memória:"

#: ../../c-api/init.rst:57

msgid ":c:func:`PyMem_RawMalloc`"

msgstr ":c:func:`PyMem_RawMalloc`"

#: ../../c-api/init.rst:58

msgid ":c:func:`PyMem_RawRealloc`"

msgstr ":c:func:`PyMem_RawRealloc`"

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

msgid ":c:func:`PyMem_RawCalloc`"

msgstr ":c:func:`PyMem_RawCalloc`"

#: ../../c-api/init.rst:60

msgid ":c:func:`PyMem_RawFree`"

msgstr ":c:func:`PyMem_RawFree`"

#: ../../c-api/init.rst:64

msgid ""

"The following functions **should not be called** before :c:func:"

"`Py_Initialize`: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:"

"`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:"

"`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:"

"`Py_GetProgramName` and :c:func:`PyEval_InitThreads`."

msgstr ""

"As seguintes funções **não devem ser chamadas** antes :c:func:"

"`Py_Initialize`: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:"

"`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:"

"`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:"

"`Py_GetProgramName` e :c:func:`PyEval_InitThreads`."

#: ../../c-api/init.rst:74

msgid "Global configuration variables"

msgstr "Variáveis de configuração global"

#: ../../c-api/init.rst:76

msgid ""

"Python has variables for the global configuration to control different "

"features and options. By default, these flags are controlled by :ref:"

"`command line options <using-on-interface-options>`."

msgstr ""

"Python tem variáveis para a configuração global a fim de controlar "

"diferentes características e opções. Por padrão, estes sinalizadores são "

"controlados por :ref:`opções de linha de comando <using-on-interface-"

"options>`."

#: ../../c-api/init.rst:80

msgid ""

"When a flag is set by an option, the value of the flag is the number of "

"times that the option was set. For example, ``-b`` sets :c:data:"

"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to "

"2."

msgstr ""

"Quando um sinalizador é definido por uma opção, o valor do sinalizador é o "

"número de vezes que a opção foi definida. Por exemplo, ``-b`` define :c:data:"

"`Py_BytesWarningFlag` para 1 e ``-bb`` define :c:data:`Py_BytesWarningFlag` "

"para 2."

#: ../../c-api/init.rst:86

msgid ""

"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :"

"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater "

"or equal to ``2``."

msgstr ""

"Emite um aviso ao comparar :class:`bytes` ou :class:`bytearray` com :class:"

"`str` ou :class:`bytes` com :class:`int`. Emite um erro se for maior ou "

"igual a ``2``."

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

msgid "Set by the :option:`-b` option."

msgstr "Definida pela opção :option:`-b`."

#: ../../c-api/init.rst:94

msgid ""

"Turn on parser debugging output (for expert only, depending on compilation "

"options)."

msgstr ""

"Ativa a saída de depuração do analisador sintático (somente para "

"especialistas, dependendo das opções de compilação)."

#: ../../c-api/init.rst:97

msgid ""

"Set by the :option:`-d` option and the :envvar:`PYTHONDEBUG` environment "

"variable."

msgstr ""

"Definida pela a opção :option:`-d` e a variável de ambiente :envvar:"

"`PYTHONDEBUG`."

#: ../../c-api/init.rst:102

msgid ""

"If set to non-zero, Python won't try to write ``.pyc`` files on the import "

"of source modules."

msgstr ""

"Se definida como diferente de zero, o Python não tentará escrever arquivos "

"``.pyc`` na importação de módulos fonte."

#: ../../c-api/init.rst:105

msgid ""

"Set by the :option:`-B` option and the :envvar:`PYTHONDONTWRITEBYTECODE` "

"environment variable."

msgstr ""

"Definida pela opção :option:`-B` e pela variável de ambiente :envvar:"

"`PYTHONDONTWRITEBYTECODE`."

#: ../../c-api/init.rst:110

msgid ""

"Suppress error messages when calculating the module search path in :c:func:"

"`Py_GetPath`."

msgstr ""

"Suprime mensagens de erro ao calcular o caminho de pesquisa do módulo em :c:"

"func:`Py_GetPath`."

#: ../../c-api/init.rst:113

msgid "Private flag used by ``_freeze_importlib`` and ``frozenmain`` programs."

msgstr ""

"Sinalizador privado usado pelos programas ``_freeze_importlib`` e "

"``frozenmain``."

#: ../../c-api/init.rst:117

msgid ""

"Set to ``1`` if the :envvar:`PYTHONHASHSEED` environment variable is set to "

"a non-empty string."

msgstr ""

"Definida como ``1`` se a variável de ambiente :envvar:`PYTHONHASHSEED` "

"estiver definida como uma string não vazia."

#: ../../c-api/init.rst:120

msgid ""

"If the flag is non-zero, read the :envvar:`PYTHONHASHSEED` environment "

"variable to initialize the secret hash seed."

msgstr ""

"Se o sinalizador for diferente de zero, lê a variável de ambiente :envvar:"

"`PYTHONHASHSEED` para inicializar a semente de hash secreta."

#: ../../c-api/init.rst:125

msgid ""

"Ignore all :envvar:`PYTHON*` environment variables, e.g. :envvar:"

"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set."

msgstr ""

"Ignora todas as variáveis de ambiente :envvar:`PYTHON*`, por exemplo :envvar:"

"`PYTHONPATH` e :envvar:`PYTHONHOME`, que pode ser definido."

#: ../../c-api/init.rst:128

msgid "Set by the :option:`-E` and :option:`-I` options."

msgstr "Definida pelas opções :option:`-E` e :option:`-I`."

#: ../../c-api/init.rst:132

msgid ""

"When a script is passed as first argument or the :option:`-c` option is "

"used, enter interactive mode after executing the script or the command, even "

"when :data:`sys.stdin` does not appear to be a terminal."

msgstr ""

"Quando um script é passado como primeiro argumento ou a opção :option:`-c` é "

"usada, entre no modo interativo após executar o script ou o comando, mesmo "

"quando :data:`sys.stdin` não parece ser um terminal."

#: ../../c-api/init.rst:136

msgid ""

"Set by the :option:`-i` option and the :envvar:`PYTHONINSPECT` environment "

"variable."

msgstr ""

"Definida pela opção :option:`-i` e pela variável de ambiente :envvar:"

"`PYTHONINSPECT`."

#: ../../c-api/init.rst:141

msgid "Set by the :option:`-i` option."

msgstr "Definida pela opção :option:`-i`."

#: ../../c-api/init.rst:145

msgid ""

"Run Python in isolated mode. In isolated mode :data:`sys.path` contains "

"neither the script's directory nor the user's site-packages directory."

msgstr ""

"Executa o Python no modo isolado. No modo isolado, :data:`sys.path` não "

"contém nem o diretório do script nem o diretório de pacotes de sites do "

"usuário."

#: ../../c-api/init.rst:148

msgid "Set by the :option:`-I` option."

msgstr "Definida pela opção :option:`-I`."

#: ../../c-api/init.rst:154

msgid ""

"If the flag is non-zero, use the ``mbcs`` encoding with ``replace`` error "

"handler, instead of the UTF-8 encoding with ``surrogatepass`` error handler, "

"for the :term:`filesystem encoding and error handler`."

msgstr ""

"Se o sinalizador for diferente de zero, use a codificação ``mbcs`` com o "

"tratador de erros ``replace``, em vez da codificação UTF-8 com o tratador de "

"erros ``surrogatepass``, para a codificação do sistema de arquivos e :term:"

"`tratador de erros e codificação do sistema de arquivos`."

#: ../../c-api/init.rst:158

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "

"variable is set to a non-empty string."

msgstr ""

"Definida como ``1`` se a variável de ambiente :envvar:"

"`PYTHONLEGACYWINDOWSFSENCODING` estiver definida como uma string não vazia."

#: ../../c-api/init.rst:161

msgid "See :pep:`529` for more details."

msgstr "Veja :pep:`529` para mais detalhes."

#: ../../c-api/init.rst:163 ../../c-api/init.rst:175

msgid ":ref:`Availability <availability>`: Windows."

msgstr ":ref:`Disponibilidade <availability>`: Windows."

#: ../../c-api/init.rst:167

msgid ""

"If the flag is non-zero, use :class:`io.FileIO` instead of :class:"

"`WindowsConsoleIO` for :mod:`sys` standard streams."

msgstr ""

"Se o sinalizador for diferente de zero, usa :class:`io.FileIO` em vez de :"

"class:`WindowsConsoleIO` para fluxos padrão :mod:`sys`."

#: ../../c-api/init.rst:170

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "

"is set to a non-empty string."

msgstr ""

"Definida como ``1`` se a variável de ambiente :envvar:"

"`PYTHONLEGACYWINDOWSSTDIO` estiver definida como uma string não vazia."

#: ../../c-api/init.rst:173

msgid "See :pep:`528` for more details."

msgstr "Veja a :pep:`528` para mais detalhes."

#: ../../c-api/init.rst:179

msgid ""

"Disable the import of the module :mod:`site` and the site-dependent "

"manipulations of :data:`sys.path` that it entails. Also disable these "

"manipulations if :mod:`site` is explicitly imported later (call :func:`site."

"main` if you want them to be triggered)."

msgstr ""

"Desabilita a importação do módulo :mod:`site` e as manipulações do :data:"

"`sys.path` que isso acarreta. Também desabilita essas manipulações se :mod:"

"`site` for explicitamente importado mais tarde (chame :func:`site.main` se "

"você quiser que eles sejam acionados)."

#: ../../c-api/init.rst:184

msgid "Set by the :option:`-S` option."

msgstr "Definida pela opção :option:`-S`."

#: ../../c-api/init.rst:188

msgid ""

"Don't add the :data:`user site-packages directory <site.USER_SITE>` to :data:"

"`sys.path`."

msgstr ""

"Não adiciona o :data:`diretório site-packages do usuário <site.USER_SITE>` "

"a :data:`sys.path`."

#: ../../c-api/init.rst:191

msgid ""

"Set by the :option:`-s` and :option:`-I` options, and the :envvar:"

"`PYTHONNOUSERSITE` environment variable."

msgstr ""

"Definida pelas opções :option:`-s` e :option:`-I`, e pela variável de "

"ambiente :envvar:`PYTHONNOUSERSITE`."

#: ../../c-api/init.rst:196

msgid ""

"Set by the :option:`-O` option and the :envvar:`PYTHONOPTIMIZE` environment "

"variable."

msgstr ""

"Definida pela opção :option:`-O` e pela variável de ambiente :envvar:"

"`PYTHONOPTIMIZE`."

#: ../../c-api/init.rst:201

msgid ""

"Don't display the copyright and version messages even in interactive mode."

msgstr ""

"Não exibe as mensagens de direitos autorais e de versão nem mesmo no modo "

"interativo."

#: ../../c-api/init.rst:203

msgid "Set by the :option:`-q` option."

msgstr "Definida pela opção :option:`-q`."

#: ../../c-api/init.rst:209

msgid "Force the stdout and stderr streams to be unbuffered."

msgstr "Força os fluxos stdout e stderr a não serem armazenados em buffer."

#: ../../c-api/init.rst:211

msgid ""

"Set by the :option:`-u` option and the :envvar:`PYTHONUNBUFFERED` "

"environment variable."

msgstr ""

"Definida pela opção :option:`-u` e pela variável de ambiente :envvar:"

"`PYTHONUNBUFFERED`."

#: ../../c-api/init.rst:216

msgid ""

"Print a message each time a module is initialized, showing the place "

"(filename or built-in module) from which it is loaded. If greater or equal "

"to ``2``, print a message for each file that is checked for when searching "

"for a module. Also provides information on module cleanup at exit."

msgstr ""

"Exibe uma mensagem cada vez que um módulo é inicializado, mostrando o local "

"(nome do arquivo ou módulo embutido) de onde ele é carregado. Se maior ou "

"igual a ``2``, exibe uma mensagem para cada arquivo que é verificado durante "

"a busca por um módulo. Também fornece informações sobre a limpeza do módulo "

"na saída."

#: ../../c-api/init.rst:221

msgid ""

"Set by the :option:`-v` option and the :envvar:`PYTHONVERBOSE` environment "

"variable."

msgstr ""

"Definida pela a opção :option:`-v` e a variável de ambiente :envvar:"

"`PYTHONVERBOSE`."

#: ../../c-api/init.rst:226

msgid "Initializing and finalizing the interpreter"

msgstr "Inicializando e encerrando o interpretador"

#: ../../c-api/init.rst:244

msgid ""

"Initialize the Python interpreter. In an application embedding Python, "

"this should be called before using any other Python/C API functions; see :"

"ref:`Before Python Initialization <pre-init-safe>` for the few exceptions."

msgstr ""

"Inicializa o interpretador Python. Em uma aplicação que incorpora o Python, "

"isto deve ser chamado antes do uso de qualquer outra função do Python/C API; "

"veja :ref:`Antes da Inicialização do Python <pre-init-safe>` para algumas "

"exceções."

#: ../../c-api/init.rst:248

msgid ""

"This initializes the table of loaded modules (``sys.modules``), and creates "

"the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:`sys`. It "

"also initializes the module search path (``sys.path``). It does not set "

"``sys.argv``; use :c:func:`PySys_SetArgvEx` for that. This is a no-op when "

"called for a second time (without calling :c:func:`Py_FinalizeEx` first). "

"There is no return value; it is a fatal error if the initialization fails."

msgstr ""

#: ../../c-api/init.rst:257

msgid ""

"On Windows, changes the console mode from ``O_TEXT`` to ``O_BINARY``, which "

"will also affect non-Python uses of the console using the C Runtime."

msgstr ""

"No Windows, altera o modo do console de ``O_TEXT`` para ``O_BINARY``, o que "

"também afetará usos não Python do console usando o Runtime C."

#: ../../c-api/init.rst:263

msgid ""

"This function works like :c:func:`Py_Initialize` if *initsigs* is ``1``. If "

"*initsigs* is ``0``, it skips initialization registration of signal "

"handlers, which might be useful when Python is embedded."

msgstr ""

#: ../../c-api/init.rst:270

msgid ""

"Return true (nonzero) when the Python interpreter has been initialized, "

"false (zero) if not. After :c:func:`Py_FinalizeEx` is called, this returns "

"false until :c:func:`Py_Initialize` is called again."

msgstr ""

"Retorna verdadeiro (diferente de zero) quando o interpretador Python foi "

"inicializado, falso (zero) se não. Após :c:func:`Py_FinalizeEx` ser chamado, "

"isso retorna falso até que :c:func:`Py_Initialize` seja chamado novamente."

#: ../../c-api/init.rst:277

msgid ""

"Undo all initializations made by :c:func:`Py_Initialize` and subsequent use "

"of Python/C API functions, and destroy all sub-interpreters (see :c:func:"

"`Py_NewInterpreter` below) that were created and not yet destroyed since the "

"last call to :c:func:`Py_Initialize`. Ideally, this frees all memory "

"allocated by the Python interpreter. This is a no-op when called for a "

"second time (without calling :c:func:`Py_Initialize` again first). Normally "

"the return value is ``0``. If there were errors during finalization "

"(flushing buffered data), ``-1`` is returned."

msgstr ""

#: ../../c-api/init.rst:286

msgid ""

"This function is provided for a number of reasons. An embedding application "

"might want to restart Python without having to restart the application "

"itself. An application that has loaded the Python interpreter from a "

"dynamically loadable library (or DLL) might want to free all memory "

"allocated by Python before unloading the DLL. During a hunt for memory leaks "

"in an application a developer might want to free all memory allocated by "

"Python before exiting from the application."

msgstr ""

"Esta função é fornecida por vários motivos. Uma aplicação de incorporação "

"pode querer reiniciar o Python sem precisar reiniciar a própria aplicação. "

"Uma aplicação que carregou o interpretador Python de uma biblioteca "

"carregável dinamicamente (ou DLL) pode querer liberar toda a memória alocada "

"pelo Python antes de descarregar a DLL. Durante uma busca por vazamentos de "

"memória em uma aplicação, um desenvolvedor pode querer liberar toda a "

"memória alocada pelo Python antes de sair da aplicação."

#: ../../c-api/init.rst:294

msgid ""

"**Bugs and caveats:** The destruction of modules and objects in modules is "

"done in random order; this may cause destructors (:meth:`__del__` methods) "

"to fail when they depend on other objects (even functions) or modules. "

"Dynamically loaded extension modules loaded by Python are not unloaded. "

"Small amounts of memory allocated by the Python interpreter may not be freed "

"(if you find a leak, please report it). Memory tied up in circular "

"references between objects is not freed. Some memory allocated by extension "

"modules may not be freed. Some extensions may not work properly if their "

"initialization routine is called more than once; this can happen if an "

"application calls :c:func:`Py_Initialize` and :c:func:`Py_FinalizeEx` more "

"than once."

msgstr ""

#: ../../c-api/init.rst:305

msgid ""

"Raises an :ref:`auditing event <auditing>` ``cpython."

"_PySys_ClearAuditHooks`` with no arguments."

msgstr ""

"Levanta um :ref:`evento de auditoria <auditing>` ``cpython."

"_PySys_ClearAuditHooks`` sem argumentos."

#: ../../c-api/init.rst:311

msgid ""

"This is a backwards-compatible version of :c:func:`Py_FinalizeEx` that "

"disregards the return value."

msgstr ""

"Esta é uma versão retrocompatível de :c:func:`Py_FinalizeEx` que "

"desconsidera o valor de retorno."

#: ../../c-api/init.rst:316

msgid "Process-wide parameters"

msgstr "Parâmetros de todo o processo"

#: ../../c-api/init.rst:326

msgid ""

"This function should be called before :c:func:`Py_Initialize`, if it is "

"called at all. It specifies which encoding and error handling to use with "

"standard IO, with the same meanings as in :func:`str.encode`."

msgstr ""

#: ../../c-api/init.rst:330

msgid ""

"It overrides :envvar:`PYTHONIOENCODING` values, and allows embedding code to "

"control IO encoding when the environment variable does not work."

msgstr ""

#: ../../c-api/init.rst:333

msgid ""

"*encoding* and/or *errors* may be ``NULL`` to use :envvar:`PYTHONIOENCODING` "

"and/or default values (depending on other settings)."

msgstr ""

#: ../../c-api/init.rst:337

msgid ""

"Note that :data:`sys.stderr` always uses the \"backslashreplace\" error "

"handler, regardless of this (or any other) setting."

msgstr ""

#: ../../c-api/init.rst:340

msgid ""

"If :c:func:`Py_FinalizeEx` is called, this function will need to be called "

"again in order to affect subsequent calls to :c:func:`Py_Initialize`."

msgstr ""

#: ../../c-api/init.rst:343

msgid ""

"Returns ``0`` if successful, a nonzero value on error (e.g. calling after "

"the interpreter has already been initialized)."

msgstr ""

#: ../../c-api/init.rst:356

msgid ""

"This function should be called before :c:func:`Py_Initialize` is called for "

"the first time, if it is called at all. It tells the interpreter the value "

"of the ``argv[0]`` argument to the :c:func:`main` function of the program "

"(converted to wide characters). This is used by :c:func:`Py_GetPath` and "

"some other functions below to find the Python run-time libraries relative to "

"the interpreter executable. The default value is ``'python'``. The "

"argument should point to a zero-terminated wide character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""

"Esta função deve ser chamada antes de :c:func:`Py_Initialize` ser chamada "

"pela primeira vez, caso seja solicitada. Ela diz ao interpretador o valor do "

"argumento ``argv[0]`` para a função :c:func:`main` do programa (convertido "

"em caracteres amplos). Isto é utilizado por :c:func:`Py_GetPath` e algumas "

"outras funções abaixo para encontrar as bibliotecas de tempo de execução "

"relativas ao executável do interpretador. O valor padrão é ``'python'``. O "

"argumento deve apontar para um caractere string amplo terminado em zero no "

"armazenamento estático, cujo conteúdo não mudará durante a execução do "

"programa. Nenhum código no interpretador Python mudará o conteúdo deste "

"armazenamento."

#: ../../c-api/init.rst:367 ../../c-api/init.rst:511 ../../c-api/init.rst:617

#: ../../c-api/init.rst:644 ../../c-api/init.rst:661

msgid ""

"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:"

"`wchar_*` string."

msgstr ""

#: ../../c-api/init.rst:375

msgid ""

"Return the program name set with :c:func:`Py_SetProgramName`, or the "

"default. The returned string points into static storage; the caller should "

"not modify its value."

msgstr ""

#: ../../c-api/init.rst:379 ../../c-api/init.rst:398 ../../c-api/init.rst:439

#: ../../c-api/init.rst:458 ../../c-api/init.rst:482 ../../c-api/init.rst:671

msgid ""

"This function should not be called before :c:func:`Py_Initialize`, otherwise "

"it returns ``NULL``."

msgstr ""

"Esta função não deve ser chamada antes de :c:func:`Py_Initialize`, caso "

"contrário ela retorna ``NULL``."

#: ../../c-api/init.rst:382 ../../c-api/init.rst:401 ../../c-api/init.rst:442

#: ../../c-api/init.rst:461 ../../c-api/init.rst:487 ../../c-api/init.rst:674

msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`."

msgstr ""

"Agora retorna ``NULL`` se for chamada antes de :c:func:`Py_Initialize`."

#: ../../c-api/init.rst:388

msgid ""

"Return the *prefix* for installed platform-independent files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:func:`Py_SetProgramName` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the prefix is "

"``'/usr/local'``. The returned string points into static storage; the caller "

"should not modify its value. This corresponds to the :makevar:`prefix` "

"variable in the top-level :file:`Makefile` and the :option:`--prefix` "

"argument to the :program:`configure` script at build time. The value is "

"available to Python code as ``sys.prefix``. It is only useful on Unix. See "

"also the next function."

msgstr ""

#: ../../c-api/init.rst:407

msgid ""

"Return the *exec-prefix* for installed platform-*dependent* files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:func:`Py_SetProgramName` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix "

"is ``'/usr/local'``. The returned string points into static storage; the "

"caller should not modify its value. This corresponds to the :makevar:"

"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-"

"prefix`` argument to the :program:`configure` script at build time. The "

"value is available to Python code as ``sys.exec_prefix``. It is only useful "

"on Unix."

msgstr ""

#: ../../c-api/init.rst:417

msgid ""

"Background: The exec-prefix differs from the prefix when platform dependent "

"files (such as executables and shared libraries) are installed in a "

"different directory tree. In a typical installation, platform dependent "

"files may be installed in the :file:`/usr/local/plat` subtree while platform "

"independent may be installed in :file:`/usr/local`."

msgstr ""

"Contexto: O exec-prefix difere do prefixo padrão quando arquivos dependentes "

"da plataforma (como executáveis e bibliotecas compartilhadas) são instalados "

"em uma árvore de diretórios diferente. Em uma instalação típica, arquivos "

"dependentes da plataforma podem ser instalados na subárvore :file:`/usr/"

"local/plat`, enquanto arquivos independentes da plataforma podem ser "

"instalados em :file:`/usr/local`."

#: ../../c-api/init.rst:423

msgid ""

"Generally speaking, a platform is a combination of hardware and software "

"families, e.g. Sparc machines running the Solaris 2.x operating system are "

"considered the same platform, but Intel machines running Solaris 2.x are "

"another platform, and Intel machines running Linux are yet another "

"platform. Different major revisions of the same operating system generally "

"also form different platforms. Non-Unix operating systems are a different "

"story; the installation strategies on those systems are so different that "

"the prefix and exec-prefix are meaningless, and set to the empty string. "

"Note that compiled Python bytecode files are platform independent (but not "

"independent from the Python version by which they were compiled!)."

msgstr ""

"De modo geral, uma plataforma é uma combinação de famílias de hardware e "

"software. Por exemplo, máquinas Sparc executando o sistema operacional "

"Solaris 2.x são consideradas a mesma plataforma, mas máquinas Intel "

"executando Solaris 2.x são outra plataforma, e máquinas Intel executando "

"Linux são uma terceira. Diferentes revisões principais do mesmo sistema "

"operacional geralmente também formam plataformas diferentes. Sistemas "

"operacionais não-Unix são um caso à parte; as estratégias de instalação "

"nesses sistemas são tão diferentes que o prefixo e o prefixo de execução são "

"irrelevantes e definidos como uma string vazia. Observe que arquivos de "

"bytecode Python compilados são independentes de plataforma (mas não "

"independentes da versão do Python com a qual foram compilados!)."

#: ../../c-api/init.rst:434

msgid ""

"System administrators will know how to configure the :program:`mount` or :"

"program:`automount` programs to share :file:`/usr/local` between platforms "

"while having :file:`/usr/local/plat` be a different filesystem for each "

"platform."

msgstr ""

"Os administradores de sistema saberão como configurar os programas :program:"

"`mount` ou :program:`automount` para compartilhar o arquivo :file:`/usr/"

"local` entre plataformas, mantendo o arquivo :file:`/usr/local/plat` como um "

"sistema de arquivos diferente para cada plataforma."

#: ../../c-api/init.rst:452

msgid ""

"Return the full program name of the Python executable; this is computed as "

"a side-effect of deriving the default module search path from the program "

"name (set by :c:func:`Py_SetProgramName` above). The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.executable``."

msgstr ""

#: ../../c-api/init.rst:472

msgid ""

"Return the default module search path; this is computed from the program "

"name (set by :c:func:`Py_SetProgramName` above) and some environment "

"variables. The returned string consists of a series of directory names "

"separated by a platform dependent delimiter character. The delimiter "

"character is ``':'`` on Unix and macOS, ``';'`` on Windows. The returned "

"string points into static storage; the caller should not modify its value. "

"The list :data:`sys.path` is initialized with this value on interpreter "

"startup; it can be (and usually is) modified later to change the search path "

"for loading modules."

msgstr ""

#: ../../c-api/init.rst:498

msgid ""

"Set the default module search path. If this function is called before :c:"

"func:`Py_Initialize`, then :c:func:`Py_GetPath` won't attempt to compute a "

"default search path but uses the one provided instead. This is useful if "

"Python is embedded by an application that has full knowledge of the location "

"of all modules. The path components should be separated by the platform "

"dependent delimiter character, which is ``':'`` on Unix and macOS, ``';'`` "

"on Windows."

msgstr ""

#: ../../c-api/init.rst:506

msgid ""

"This also causes :data:`sys.executable` to be set to the program full path "

"(see :c:func:`Py_GetProgramFullPath`) and for :data:`sys.prefix` and :data:"

"`sys.exec_prefix` to be empty. It is up to the caller to modify these if "

"required after calling :c:func:`Py_Initialize`."

msgstr ""

#: ../../c-api/init.rst:514

msgid ""

"The path argument is copied internally, so the caller may free it after the "

"call completes."

msgstr ""

"O argumento caminho é copiado internamente, então o chamador pode liberá-lo "

"depois da finalização da chamada."

#: ../../c-api/init.rst:517

msgid ""

"The program full path is now used for :data:`sys.executable`, instead of the "

"program name."

msgstr ""

"O caminho completo do programa agora é utilizado para :data:`sys."

"executable`, em vez do nome do programa."

#: ../../c-api/init.rst:524

msgid ""

"Return the version of this Python interpreter. This is a string that looks "

"something like ::"

msgstr ""

"Retorna a verão deste interpretador Python. Esta é uma string que se parece "

"com ::"

#: ../../c-api/init.rst:531

msgid ""

"The first word (up to the first space character) is the current Python "

"version; the first characters are the major and minor version separated by a "

"period. The returned string points into static storage; the caller should "

"not modify its value. The value is available to Python code as :data:`sys."

"version`."

msgstr ""

"A primeira palavra (até o primeiro espaço em branco) representa a versão "

"atual do Python; os primeiros caracteres indicam a versão principal e a "

"versão secundária, separados por um ponto. A string retornada aponta para um "

"armazenamento estático; o chamador não deve modificar seu valor. O valor "

"fica disponível para o código Python como :data:`sys.version`."

#: ../../c-api/init.rst:541

msgid ""

"Return the platform identifier for the current platform. On Unix, this is "

"formed from the \"official\" name of the operating system, converted to "

"lower case, followed by the major revision number; e.g., for Solaris 2.x, "

"which is also known as SunOS 5.x, the value is ``'sunos5'``. On macOS, it "

"is ``'darwin'``. On Windows, it is ``'win'``. The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.platform``."

msgstr ""

"Retorna o identificador da plataforma atual. No Unix, este identificador é "

"formado pelo nome \"oficial\" do sistema operacional, convertido para "

"minúsculas, seguido pelo número da revisão principal; por exemplo, para "

"Solaris 2.x, também conhecido como SunOS 5.x, o valor é ``'sunos5'``. No "

"macOS, é ``'darwin'``. No Windows, é ``'win'``. A string retornada aponta "

"para um armazenamento estático; o chamador não deve modificar seu valor. O "

"valor está disponível para o código Python como ``sys.platform``."

#: ../../c-api/init.rst:552

msgid ""

"Return the official copyright string for the current Python version, for "

"example"

msgstr ""

"Retorna a string oficial de direitos autoriais para a versão atual do "

"Python, por exemplo"

#: ../../c-api/init.rst:554

msgid "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``"

msgstr "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``"

#: ../../c-api/init.rst:558

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as ``sys.copyright``."

msgstr ""

"A string retornada aponta para o armazenamento estático; o chamador não deve "

"modificar o seu valor. O valor está disponível para o código Python como "

"``sys.copyright``."

#: ../../c-api/init.rst:564

msgid ""

"Return an indication of the compiler used to build the current Python "

"version, in square brackets, for example::"

msgstr ""

"Retorna uma indicação do compilador usado para construir a atual versão do "

"Python, em colchetes, por exemplo::"

#: ../../c-api/init.rst:571 ../../c-api/init.rst:585

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as part of the variable "

"``sys.version``."

msgstr ""

"A string retornada aponta para o armazenamento estático; o chamador não deve "

"modificar o seu valor. O valor está disponível para o código Python como "

"``sys.version``."

#: ../../c-api/init.rst:578

msgid ""

"Return information about the sequence number and build date and time of the "

"current Python interpreter instance, for example ::"

msgstr ""

"Retorna informação sobre o número de sequência e a data e hora da construção "

"da instância atual do interpretador Python, por exemplo ::"

#: ../../c-api/init.rst:597

msgid ""

"Set :data:`sys.argv` based on *argc* and *argv*. These parameters are "

"similar to those passed to the program's :c:func:`main` function with the "

"difference that the first entry should refer to the script file to be "

"executed rather than the executable hosting the Python interpreter. If "

"there isn't a script that will be run, the first entry in *argv* can be an "

"empty string. If this function fails to initialize :data:`sys.argv`, a "

"fatal condition is signalled using :c:func:`Py_FatalError`."

msgstr ""

"Define :data:`sys.argv` com base em *argc* e *argv*. Esses parâmetros são "

"semelhantes aos passados para a função :c:func:`main` do programa, com a "

"diferença de que a primeira entrada deve se referir ao arquivo de script a "

"ser executado, em vez do executável que hospeda o interpretador Python. Se "

"não houver um script a ser executado, a primeira entrada em *argv* pode ser "

"uma string vazia. Se esta função falhar ao inicializar :data:`sys.argv`, uma "

"condição fatal será sinalizada usando :c:func:`Py_FatalError`."

#: ../../c-api/init.rst:605

msgid ""

"If *updatepath* is zero, this is all the function does. If *updatepath* is "

"non-zero, the function also modifies :data:`sys.path` according to the "

"following algorithm:"

msgstr ""

"Se *updatepath* é zero, isto é tudo o que a função faz. Se *updatepath* não "

"é zero, a função também modifica :data:`sys.path` de acordo com o seguinte "

"algoritmo:"

#: ../../c-api/init.rst:609

msgid ""

"If the name of an existing script is passed in ``argv[0]``, the absolute "

"path of the directory where the script is located is prepended to :data:`sys."

"path`."

msgstr ""

"Se o nome de um script existente for passado em ``argv[0]``, o caminho "

"absoluto do diretório onde o script está localizado será adicionado a :data:"

"`sys.path`."

#: ../../c-api/init.rst:612

msgid ""

"Otherwise (that is, if *argc* is ``0`` or ``argv[0]`` doesn't point to an "

"existing file name), an empty string is prepended to :data:`sys.path`, which "

"is the same as prepending the current working directory (``\".\"``)."

msgstr ""

"Caso contrário (isto é, se *argc* for ``0`` ou ``argv[0]`` não apontar para "

"um nome de arquivo existente), uma string vazia é adicionada ao início de :"

"data:`sys.path`, o que é o mesmo que adicionar o diretório de trabalho atual "

"(``\".\"``)."

#: ../../c-api/init.rst:621

msgid ""

"It is recommended that applications embedding the Python interpreter for "

"purposes other than executing a single script pass ``0`` as *updatepath*, "

"and update :data:`sys.path` themselves if desired. See `CVE-2008-5983 "

"<https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_."

msgstr ""

#: ../../c-api/init.rst:626

msgid ""

"On versions before 3.1.3, you can achieve the same effect by manually "

"popping the first :data:`sys.path` element after having called :c:func:"

"`PySys_SetArgv`, for example using::"

msgstr ""

"Em versões anteriores à 3.1.3, você pode obter o mesmo efeito removendo "

"manualmente o primeiro elemento de :data:`sys.path` após ter chamado :c:func:"

"`PySys_SetArgv`, por exemplo, usando::"

#: ../../c-api/init.rst:640

msgid ""

"This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to "

"``1`` unless the :program:`python` interpreter was started with the :option:"

"`-I`."

msgstr ""

"Esta função funciona como :c:func:`PySys_SetArgvEx` com *updatepath* "

"definido como ``1`` a menos que o interpretador :program:`python` tenha sido "

"iniciado com a :option:`-I`."

#: ../../c-api/init.rst:647

msgid "The *updatepath* value depends on :option:`-I`."

msgstr "O valor *updatepath* depende de :option:`-I`."

#: ../../c-api/init.rst:652

msgid ""

"Set the default \"home\" directory, that is, the location of the standard "

"Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument "

"string."

msgstr ""

"Define o diretório pessoal (\"home\") padrão, ou seja, o local das "

"bibliotecas padrão do Python. Consulte :envvar:`PYTHONHOME` para obter o "

"significado da string do argumento."

#: ../../c-api/init.rst:656

msgid ""

"The argument should point to a zero-terminated character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""