interpreter.po

# 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:58+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"

#: ../../tutorial/interpreter.rst:5
msgid "Using the Python Interpreter"
msgstr "Utilizando o interpretador Python"

#: ../../tutorial/interpreter.rst:11
msgid "Invoking the Interpreter"
msgstr "Chamando o interpretador"

#: ../../tutorial/interpreter.rst:13
msgid ""
"The Python interpreter is usually installed as :file:`/usr/local/bin/"
"python3.10` on those machines where it is available; putting :file:`/usr/"
"local/bin` in your Unix shell's search path makes it possible to start it by "
"typing the command:"
msgstr ""
"O interpretador Python é frequentemente instalado como :file:`/usr/local/bin/"
"python3.10` nas máquinas onde está disponível; adicionando :file:`/usr/local/"
"bin` ao caminho de busca da shell de seu Unix torna-se possível iniciá-lo "
"digitando o comando:"

#: ../../tutorial/interpreter.rst:21
msgid ""
"to the shell. [#]_ Since the choice of the directory where the interpreter "
"lives is an installation option, other places are possible; check with your "
"local Python guru or system administrator.  (E.g., :file:`/usr/local/python` "
"is a popular alternative location.)"
msgstr ""
"no shell. [#]_ Considerando que a escolha do diretório onde o interpretador "
"está é uma opção de instalação, outros locais são possíveis; verifique com "
"seu guru local de Python ou administrador do sistema local. (Por exemplo, :"
"file:`/usr/local/python` é um local alternativo popular.)"

#: ../../tutorial/interpreter.rst:26
msgid ""
"On Windows machines where you have installed Python from the :ref:`Microsoft "
"Store <windows-store>`, the :file:`python3.10` command will be available. If "
"you have the :ref:`py.exe launcher <launcher>` installed, you can use the :"
"file:`py` command. See :ref:`setting-envvars` for other ways to launch "
"Python."
msgstr ""
"Em máquinas Windows onde você instalou Python a partir da :ref:`Microsoft "
"Store <windows-store>`, o comando :file:`python3.10` estará disponível. Se "
"você tem o :ref:`lançador py.exe <launcher>` instalado, você pode usar o "
"comando :file:`py`. Veja :ref:`setting-envvars` para outras maneiras de "
"executar o Python."

#: ../../tutorial/interpreter.rst:31
msgid ""
"Typing an end-of-file character (:kbd:`Control-D` on Unix, :kbd:`Control-Z` "
"on Windows) at the primary prompt causes the interpreter to exit with a zero "
"exit status.  If that doesn't work, you can exit the interpreter by typing "
"the following command: ``quit()``."
msgstr ""
"Digitar um caractere de fim de arquivo (:kbd:`Control-D` no Unix, :kbd:"
"`Control-Z` no Windows) diretamente no prompt força o interpretador a sair "
"com status de saída zero. Se isso não funcionar, você pode sair do "
"interpretador digitando o seguinte comando: ``quit()``."

#: ../../tutorial/interpreter.rst:36
msgid ""
"The interpreter's line-editing features include interactive editing, history "
"substitution and code completion on systems that support the `GNU Readline "
"<https://tiswww.case.edu/php/chet/readline/rltop.html>`_ library. Perhaps "
"the quickest check to see whether command line editing is supported is "
"typing :kbd:`Control-P` to the first Python prompt you get.  If it beeps, "
"you have command line editing; see Appendix :ref:`tut-interacting` for an "
"introduction to the keys.  If nothing appears to happen, or if ``^P`` is "
"echoed, command line editing isn't available; you'll only be able to use "
"backspace to remove characters from the current line."
msgstr ""
"Os recursos de edição de linha do interpretador incluem edição interativa, "
"substituição de histórico e complemento de código, em sistemas com suporte à "
"biblioteca `GNU Readline <https://tiswww.case.edu/php/chet/readline/rltop."
"html>`_. Talvez a verificação mais rápida para ver se o suporte à edição de "
"linha de comando está disponível é digitando :kbd:`Control-P` no primeiro "
"prompt oferecido pelo Python. Se for emitido um bipe, você terá a edição da "
"linha de comando; veja Apêndice :ref:`tut-interacting` para uma introdução "
"às combinações. Se nada acontecer, ou se ``^P`` aparecer na tela, a edição "
"da linha de comando não está disponível; você só poderá usar backspace para "
"remover caracteres da linha atual."

#: ../../tutorial/interpreter.rst:46
msgid ""
"The interpreter operates somewhat like the Unix shell: when called with "
"standard input connected to a tty device, it reads and executes commands "
"interactively; when called with a file name argument or with a file as "
"standard input, it reads and executes a *script* from that file."
msgstr ""
"O interpretador trabalha de forma semelhante a uma shell de Unix: quando "
"chamado com a saída padrão conectada a um console de terminal, ele lê e "
"executa comandos interativamente; quando chamado com um nome de arquivo como "
"argumento, ou com redirecionamento da entrada padrão para ler um arquivo, o "
"interpretador lê e executa o *script* contido no arquivo."

#: ../../tutorial/interpreter.rst:51
msgid ""
"A second way of starting the interpreter is ``python -c command [arg] ...``, "
"which executes the statement(s) in *command*, analogous to the shell's :"
"option:`-c` option.  Since Python statements often contain spaces or other "
"characters that are special to the shell, it is usually advised to quote "
"*command* in its entirety."
msgstr ""
"Uma segunda forma de iniciar o interpretador é ``python -c comando [arg] ..."
"``, que executa uma ou mais instruções especificadas na posição *comando*, "
"analogamente à opção de shell :option:`-c`. Considerando que comandos Python "
"frequentemente têm espaços em branco (ou outros caracteres que são especiais "
"para a shell) é aconselhável que todo o *comando* esteja entre as aspas."

#: ../../tutorial/interpreter.rst:57
msgid ""
"Some Python modules are also useful as scripts.  These can be invoked using "
"``python -m module [arg] ...``, which executes the source file for *module* "
"as if you had spelled out its full name on the command line."
msgstr ""
"Alguns módulos Python são também úteis como scripts. Estes podem ser "
"chamados usando ``python -m módulo [arg] ...`` que executa o arquivo fonte "
"do *módulo* como se você tivesse digitado seu caminho completo na linha de "
"comando."

#: ../../tutorial/interpreter.rst:61
msgid ""
"When a script file is used, it is sometimes useful to be able to run the "
"script and enter interactive mode afterwards.  This can be done by passing :"
"option:`-i` before the script."
msgstr ""
"Quando um arquivo de script é utilizado, às vezes é útil executá-lo e logo "
"em seguida entrar em modo interativo. Isto pode ser feito acrescentando o "
"argumento :option:`-i` antes do nome do script."

#: ../../tutorial/interpreter.rst:65
msgid "All command line options are described in :ref:`using-on-general`."
msgstr ""
"Todas as opções de linha de comando são descritas em :ref:`using-on-general`."

#: ../../tutorial/interpreter.rst:71
msgid "Argument Passing"
msgstr "Passagem de argumentos"

#: ../../tutorial/interpreter.rst:73
msgid ""
"When known to the interpreter, the script name and additional arguments "
"thereafter are turned into a list of strings and assigned to the ``argv`` "
"variable in the ``sys`` module.  You can access this list by executing "
"``import sys``.  The length of the list is at least one; when no script and "
"no arguments are given, ``sys.argv[0]`` is an empty string.  When the script "
"name is given as ``'-'`` (meaning  standard input), ``sys.argv[0]`` is set "
"to ``'-'``.  When :option:`-c` *command* is used, ``sys.argv[0]`` is set to "
"``'-c'``.  When :option:`-m` *module* is used, ``sys.argv[0]``  is set to "
"the full name of the located module.  Options found after  :option:`-c` "
"*command* or :option:`-m` *module* are not consumed  by the Python "
"interpreter's option processing but left in ``sys.argv`` for  the command or "
"module to handle."
msgstr ""
"Quando são de conhecimento do interpretador, o nome do script e demais "
"argumentos da linha de comando da shell são acessíveis ao próprio script "
"através da variável ``argv`` do módulo ``sys``. Pode-se acessar essa lista "
"executando ``import sys``. Essa lista tem sempre ao menos um elemento; "
"quando nenhum script ou argumento for passado para o interpretador, ``sys."
"argv[0]`` será uma string vazia. Quando o nome do script for ``'-'`` "
"(significando entrada padrão), o conteúdo de ``sys.argv[0]`` será ``'-'``. "
"Quando for utilizado :option:`-c` *comando*, ``sys.argv[0]`` conterá ``'-"
"c'``. Quando for utilizado :option:`-m` *módulo*, ``sys.argv[0]`` conterá o "
"caminho completo do módulo localizado. Opções especificadas após :option:`-"
"c` *comando* ou :option:`-m` *módulo* não serão consumidas pelo "
"interpretador mas deixadas em ``sys.argv`` para serem tratadas pelo comando "
"ou módulo."

#: ../../tutorial/interpreter.rst:89
msgid "Interactive Mode"
msgstr "Modo interativo"

#: ../../tutorial/interpreter.rst:91
msgid ""
"When commands are read from a tty, the interpreter is said to be in "
"*interactive mode*.  In this mode it prompts for the next command with the "
"*primary prompt*, usually three greater-than signs (``>>>``); for "
"continuation lines it prompts with the *secondary prompt*, by default three "
"dots (``...``). The interpreter prints a welcome message stating its version "
"number and a copyright notice before printing the first prompt:"
msgstr ""
"Quando os comandos são lidos a partir do console, diz-se que o interpretador "
"está em modo interativo. Nesse modo ele solicita um próximo comando através "
"do *prompt primário*, tipicamente três sinais de maior (``>>>``); para "
"linhas de continuação do comando atual, o *prompt secundário* padrão é "
"formado por três pontos (``...``). O interpretador exibe uma mensagem de "
"boas vindas, informando seu número de versão e um aviso de copyright antes "
"de exibir o primeiro prompt::"

#: ../../tutorial/interpreter.rst:108
msgid ""
"Continuation lines are needed when entering a multi-line construct. As an "
"example, take a look at this :keyword:`if` statement::"
msgstr ""
"Linhas de continuação são necessárias em construções multi-linha. Como "
"exemplo, dê uma olhada nesse comando :keyword:`if`::"

#: ../../tutorial/interpreter.rst:118
msgid "For more on interactive mode, see :ref:`tut-interac`."
msgstr ""
"Para mais informações sobre o modo interativo, veja :ref:`tut-interac`."

#: ../../tutorial/interpreter.rst:124
msgid "The Interpreter and Its Environment"
msgstr "O interpretador e seu ambiente"

#: ../../tutorial/interpreter.rst:130
msgid "Source Code Encoding"
msgstr "Edição de código-fonte"

#: ../../tutorial/interpreter.rst:132
msgid ""
"By default, Python source files are treated as encoded in UTF-8.  In that "
"encoding, characters of most languages in the world can be used "
"simultaneously in string literals, identifiers and comments --- although the "
"standard library only uses ASCII characters for identifiers, a convention "
"that any portable code should follow.  To display all these characters "
"properly, your editor must recognize that the file is UTF-8, and it must use "
"a font that supports all the characters in the file."
msgstr ""
"Por padrão, arquivos fonte de Python são tratados com codificação UTF-8. "
"Nessa codificação, caracteres de muitos idiomas no mundo podem ser usados "
"simultaneamente em literais string, identificadores e comentários --- embora "
"a biblioteca padrão use apenas caracteres ASCII para identificadores, uma "
"convenção que qualquer código portável deve seguir. Para exibir todos esses "
"caracteres corretamente, seu editor deve reconhecer que o arquivo é UTF-8 e "
"deve usar uma fonte com suporte a todos os caracteres no arquivo."

#: ../../tutorial/interpreter.rst:140
msgid ""
"To declare an encoding other than the default one, a special comment line "
"should be added as the *first* line of the file.  The syntax is as follows::"
msgstr ""
"Para declarar uma codificação diferente da padrão, uma linha de comentário "
"especial deve ser adicionada como *primeira* linha do arquivo. A sintaxe é "
"essa::"

#: ../../tutorial/interpreter.rst:145
msgid "where *encoding* is one of the valid :mod:`codecs` supported by Python."
msgstr "onde *encoding* é uma das :mod:`codecs` válidas com suporte do Python."

#: ../../tutorial/interpreter.rst:147
msgid ""
"For example, to declare that Windows-1252 encoding is to be used, the first "
"line of your source code file should be::"
msgstr ""
"Por exemplo, para declarar que a codificação Windows-1252 deve ser usada, a "
"primeira linha do seu arquivo fonte deve ser::"

#: ../../tutorial/interpreter.rst:152
msgid ""
"One exception to the *first line* rule is when the source code starts with "
"a :ref:`UNIX \"shebang\" line <tut-scripts>`.  In this case, the encoding "
"declaration should be added as the second line of the file.  For example::"
msgstr ""
"Uma exceção para a regra da *primeira linha* é quando o código-fonte inicia "
"com uma :ref:`linha com UNIX \"shebang\" <tut-scripts>`. Nesse caso, a "
"declaração de codificação deve ser adicionada como a segunda linha do "
"arquivo. Por exemplo::"

#: ../../tutorial/interpreter.rst:160
msgid "Footnotes"
msgstr "Notas de rodapé"

#: ../../tutorial/interpreter.rst:161
msgid ""
"On Unix, the Python 3.x interpreter is by default not installed with the "
"executable named ``python``, so that it does not conflict with a "
"simultaneously installed Python 2.x executable."
msgstr ""
"No Unix, o interpretador Python 3.x não é instalado por padrão com o "
"executável nomeado ``python``, então não vai conflitar com um executável "
"Python 2.x instalado simultaneamente."