python-docs-pt-br/c-api/veryhigh.po at 3.15 · python/python-docs-pt-br

807 lines (721 loc) · 34 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# python-doc bot, 2025
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-07-19 14:48+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
"teams/5390/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
"1000000 == 0 ? 1 : 2;\n"
#: ../../c-api/veryhigh.rst:8
msgid "The Very High Level Layer"
msgstr "A camada de nível muito alto"
#: ../../c-api/veryhigh.rst:10
"The functions in this chapter will let you execute Python source code given "
"in a file or a buffer, but they will not let you interact in a more detailed "
"way with the interpreter."
"As funções neste capítulo permitirão que você execute um código-fonte Python "
"fornecido em um arquivo ou buffer, mas não permitirão que você interaja de "
"forma mais detalhada com o interpretador."
#: ../../c-api/veryhigh.rst:14
"Several of these functions accept a start symbol from the grammar as a "
"parameter.  The available start symbols are :c:data:`Py_eval_input`, :c:data:"
"`Py_file_input`, :c:data:`Py_single_input`, and :c:data:"
"`Py_func_type_input`.  These are described following the functions which "
"accept them as parameters."
"Várias dessas funções aceitam um símbolo de início da gramática como "
"parâmetro. Os símbolos de início disponíveis são :c:data:`Py_eval_input`, :c:"
"data:`Py_file_input` e :c:data:`Py_single_input` e :c:data:"
"`Py_func_type_input`. Eles são descritos seguindo as funções que os aceitam "
"como parâmetros."
#: ../../c-api/veryhigh.rst:20
"Note also that several of these functions take :c:expr:`FILE*` parameters.  "
"One particular issue which needs to be handled carefully is that the :c:type:"
"`FILE` structure for different C libraries can be different and "
"incompatible.  Under Windows (at least), it is possible for dynamically "
"linked extensions to actually use different libraries, so care should be "
"taken that :c:expr:`FILE*` parameters are only passed to these functions if "
"it is certain that they were created by the same library that the Python "
"runtime is using."
"Note também que várias dessas funções aceitam parâmetros :c:expr:`FILE*`. Um "
"problema específico que precisa ser tratado com cuidado é que a estrutura :c:"
"type:`FILE` para diferentes bibliotecas C pode ser diferente e incompatível. "
"No Windows (pelo menos), é possível que extensões vinculadas dinamicamente "
"usem bibliotecas diferentes, então deve-se tomar cuidado para que os "
"parâmetros :c:expr:`FILE*` sejam passados para essas funções somente se for "
"certo que elas foram criadas pela mesma biblioteca que o tempo de execução "
"do Python está usando."
#: ../../c-api/veryhigh.rst:31
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_AnyFileExFlags` "
"abaixo, deixando *closeit* definido como ``0`` e *flags* definido como "
"``NULL``."
#: ../../c-api/veryhigh.rst:37
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving the *closeit* argument set to ``0``."
"Esta é uma interface simplificada para :c:func:`PyRun_AnyFileExFlags` "
"abaixo, deixando o argumento *closeit* definido como ``0``."
#: ../../c-api/veryhigh.rst:43
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving the *flags* argument set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_AnyFileExFlags` "
"abaixo, deixando o argumento *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:49
"If *fp* refers to a file associated with an interactive device (console or "
"terminal input or Unix pseudo-terminal), return the value of :c:func:"
"`PyRun_InteractiveLoop`, otherwise return the result of :c:func:"
"`PyRun_SimpleFile`.  *filename* is decoded from the filesystem encoding (:"
"func:`sys.getfilesystemencoding`).  If *filename* is ``NULL``, this function "
"uses ``\"???\"`` as the filename. If *closeit* is true, the file is closed "
"before ``PyRun_SimpleFileExFlags()`` returns."
"Se *fp* se referir a um arquivo associado a um dispositivo interativo "
"(entrada de console ou terminal ou pseudo-terminal Unix), retorna o valor "
"de :c:func:`PyRun_InteractiveLoop`, caso contrário, retorna o resultado de :"
"c:func:`PyRun_SimpleFile`. *filename* é decodificado da codificação do "
"sistema de arquivos (:func:`sys.getfilesystemencoding`). Se *filename* for "
"``NULL``, esta função usa ``\"???\"`` como o nome do arquivo. Se *closeit* "
"for verdadeiro, o arquivo será fechado antes de "
"``PyRun_SimpleFileExFlags()`` retornar."
#: ../../c-api/veryhigh.rst:61
"This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, "
"leaving the :c:struct:`PyCompilerFlags`\\* argument set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_SimpleStringFlags` "
"abaixo, deixando o argumento :c:struct:`PyCompilerFlags`\\* definido como "
"``NULL``."
#: ../../c-api/veryhigh.rst:67
"Executes the Python source code from *command* in the :mod:`__main__` module "
"according to the *flags* argument. If :mod:`__main__` does not already "
"exist, it is created.  Returns ``0`` on success or ``-1`` if an exception "
"was raised.  If there was an error, there is no way to get the exception "
"information. For the meaning of *flags*, see below."
"Executa o código-fonte Python de *command* no módulo :mod:`__main__` de "
"acordo com o argumento *flags*. Se :mod:`__main__` ainda não existir, ele "
"será criado. Retorna ``0`` em caso de sucesso ou ``-1`` se uma exceção foi "
"gerada. Se houve um erro, não há como obter as informações da exceção. Para "
"o significado de *flags*, veja abaixo."
#: ../../c-api/veryhigh.rst:73
"Note that if an otherwise unhandled :exc:`SystemExit` is raised, this "
"function will not return ``-1``, but exit the process, as long as :c:member:"
"`PyConfig.inspect` is zero."
"Observe que se uma exceção :exc:`SystemExit` não tratada for levantada, esta "
"função não retornará ``-1``, mas sairá do processo, desde que :c:member:"
"`PyConfig.inspect` seja zero."
#: ../../c-api/veryhigh.rst:80
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_SimpleFileExFlags` "
"abaixo, deixando *closeit* definido como ``0`` e *flags* definido como "
"``NULL``."
#: ../../c-api/veryhigh.rst:86
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
"leaving *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_SimpleFileExFlags` "
"abaixo, deixando o *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:92
"Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is "
"read from *fp* instead of an in-memory string. *filename* should be the name "
"of the file, it is decoded from :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before "
"``PyRun_SimpleFileExFlags()`` returns."
"Semelhante a :c:func:`PyRun_SimpleStringFlags`, mas o código-fonte Python é "
"lido de *fp* em vez de uma string na memória. *filename* deve ser o nome do "
"arquivo, ele é decodificado a partir do :term:`tratador de erros e "
"codificação do sistema de arquivos`. Se *closeit* for true, o arquivo será "
"fechado antes que ``PyRun_SimpleFileExFlags()`` retorne."
#: ../../c-api/veryhigh.rst:99
"On Windows, *fp* should be opened as binary mode (e.g. ``fopen(filename, "
"\"rb\")``). Otherwise, Python may not handle script file with LF line ending "
"correctly."
"No Windows, *fp* deve ser aberto como modo binário (por exemplo, "
"``fopen(filename, \"rb\")``). Caso contrário, o Python pode não manipular "
"corretamente o arquivo de script com final de linha LF."
#: ../../c-api/veryhigh.rst:105
"Read and execute a single statement from a file associated with an "
"interactive device according to the *flags* argument.  The user will be "
"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* must be a Python :"
"class:`str` object."
"Lê e executa uma única instrução de um arquivo associado a um dispositivo "
"interativo de acordo com o argumento *flags*. O usuário será solicitado "
"usando ``sys.ps1`` e ``sys.ps2``. *filename* deve ser um objeto :class:`str` "
#: ../../c-api/veryhigh.rst:110
"Returns ``0`` when the input was executed successfully, ``-1`` if there was "
"an exception, or an error code from the :file:`errcode.h` include file "
"distributed as part of Python if there was a parse error.  (Note that :file:"
"`errcode.h` is not included by :file:`Python.h`, so must be included "
"specifically if needed.)"
"Retorna ``0`` quando a entrada foi executada com sucesso, ``-1`` se houve "
"uma exceção ou um código de erro do arquivo de inclusão :file:`errcode.h` "
"distribuído como parte do Python se houve um erro de análise. (Observe que :"
"file:`errcode.h` não é incluído por :file:`Python.h`, então deve ser "
"incluído especificamente se necessário.)"
#: ../../c-api/veryhigh.rst:119
"This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, "
"leaving *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_InteractiveOneFlags` "
"abaixo, deixando *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:125
"Similar to :c:func:`PyRun_InteractiveOneObject`, but *filename* is a :c:expr:"
"`const char*`, which is decoded from the :term:`filesystem encoding and "
"error handler`."
"Semelhante a :c:func:`PyRun_InteractiveOneObject`, mas *filename* é um :c:"
"expr:`const char *`, que é decodificado a partir do :term:`tratador de erros "
"e codificação do sistema de arquivos`."
#: ../../c-api/veryhigh.rst:132
"This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` "
"below, leaving *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_InteractiveLoopFlags` "
"abaixo, deixando *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:138
"Read and execute statements from a file associated with an interactive "
"device until EOF is reached.  The user will be prompted using ``sys.ps1`` "
"and ``sys.ps2``.  *filename* is decoded from the :term:`filesystem encoding "
"and error handler`.  Returns ``0`` at EOF or a negative number upon failure."
"Lê e executa instruções de um arquivo associado a um dispositivo interativo "
"até que o EOF seja atingido. O usuário será consultado usando ``sys.ps1`` e "
"``sys.ps2``. *filename* é decodificado a partir do :term:`tratador de erros "
"e codificação do sistema de arquivos`. Retorna ``0`` no EOF ou um número "
"negativo em caso de falha."
#: ../../c-api/veryhigh.rst:146
"Can be set to point to a function with the prototype ``int func(void)``.  "
"The function will be called when Python's interpreter prompt is about to "
"become idle and wait for user input from the terminal.  The return value is "
"ignored.  Overriding this hook can be used to integrate the interpreter's "
"prompt with other event loops, as done in :file:`Modules/_tkinter.c` in the "
"Python source code."
"Pode ser definido para apontar para uma função com o protótipo ``int "
"func(void)``. A função será chamada quando o prompt do interpretador do "
"Python estiver prestes a ficar ocioso e aguardar a entrada do usuário no "
"terminal. O valor de retorno é ignorado. A substituição deste hook pode ser "
"usada para integrar o prompt do interpretador com outros laços de eventos, "
"como feito em :file:`Modules/_tkinter.c` no código-fonte do Python."
#: ../../c-api/veryhigh.rst:154 ../../c-api/veryhigh.rst:178
"This function is only called from the :ref:`main interpreter <sub-"
"interpreter-support>`."
"Esta função só é chamada pelo :ref:`interpretador principal <sub-interpreter-"
"support>`."
#: ../../c-api/veryhigh.rst:161
"Can be set to point to a function with the prototype ``char *func(FILE "
"*stdin, FILE *stdout, char *prompt)``, overriding the default function used "
"to read a single line of input at the interpreter's prompt.  The function is "
"expected to output the string *prompt* if it's not ``NULL``, and then read a "
"line of input from the provided standard input file, returning the resulting "
"string.  For example, The :mod:`readline` module sets this hook to provide "
"line-editing and tab-completion features."
"Pode ser definido para apontar para uma função com o protótipo ``char "
"*func(FILE *stdin, FILE *stdout, char *prompt)``, substituindo a função "
"padrão usada para ler uma única linha de entrada no prompt do interpretador. "
"Espera-se que a função produza a string *prompt* se não for ``NULL`` e, em "
"seguida, leia uma linha de entrada do arquivo de entrada padrão fornecido, "
"retornando a string resultante. Por exemplo, o módulo :mod:`readline` define "
"este gancho para fornecer recursos de edição de linha e preenchimento de "
"tabulação."
#: ../../c-api/veryhigh.rst:170
"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:"
"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred."
"O resultado deve ser uma string alocada por :c:func:`PyMem_RawMalloc` ou :c:"
"func:`PyMem_RawRealloc`, ou ``NULL`` se ocorrer um erro."
#: ../../c-api/veryhigh.rst:173
"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:"
"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :"
"c:func:`PyMem_Realloc`."
"O resultado deve ser alocado por :c:func:`PyMem_RawMalloc` ou :c:func:"
"`PyMem_RawRealloc`, em vez de ser alocado por :c:func:`PyMem_Malloc` ou :c:"
"func:`PyMem_Realloc`."
#: ../../c-api/veryhigh.rst:184
"This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving "
"*flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_StringFlags` abaixo, "
"deixando *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:190
"Execute Python source code from *str* in the context specified by the "
"objects *globals* and *locals* with the compiler flags specified by "
"*flags*.  *globals* must be a dictionary; *locals* can be any object that "
"implements the mapping protocol.  The parameter *start* specifies the start "
"symbol and must be one of the :ref:`available start symbols <start-symbols>`."
#: ../../c-api/veryhigh.rst:196
"Returns the result of executing the code as a Python object, or ``NULL`` if "
"an exception was raised."
"Retorna o resultado da execução do código como um objeto Python, ou ``NULL`` "
"se uma exceção foi levantada."
#: ../../c-api/veryhigh.rst:202
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0`` and *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_FileExFlags` abaixo, "
"deixando *closeit* definido como ``0`` e *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:208
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`PyRun_FileExFlags` abaixo, "
"deixando *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:214
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0``."
"Esta é uma interface simplificada para :c:func:`PyRun_FileExFlags` abaixo, "
"deixando *closeit* definido como ``0``."
#: ../../c-api/veryhigh.rst:220
"Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read "
"from *fp* instead of an in-memory string. *filename* should be the name of "
"the file, it is decoded from the :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before :c:func:"
"`PyRun_FileExFlags` returns."
"Semelhante a :c:func:`PyRun_StringFlags`, mas o código-fonte Python é lido "
"de *fp* em vez de uma string na memória. *filename* deve ser o nome do "
"arquivo, ele é decodificado a partir do :term:`tratador de erros e "
"codificação do sistema de arquivos`. Se *closeit* for true, o arquivo será "
"fechado antes que :c:func:`PyRun_FileExFlags` retorne."
#: ../../c-api/veryhigh.rst:229
"This is a simplified interface to :c:func:`Py_CompileStringFlags` below, "
"leaving *flags* set to ``NULL``."
"Esta é uma interface simplificada para :c:func:`Py_CompileStringFlags` "
"abaixo, deixando *flags* definido como ``NULL``."
#: ../../c-api/veryhigh.rst:235
"This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, "
"with *optimize* set to ``-1``."
"Esta é uma interface simplificada para :c:func:`Py_CompileStringExFlags` "
"abaixo, com *optimize* definido como ``-1``."
#: ../../c-api/veryhigh.rst:241
"Parse and compile the Python source code in *str*, returning the resulting "
"code object.  The start symbol is given by *start*; this can be used to "
"constrain the code which can be compiled and should be :ref:`available start "
"symbols <start-symbols>`.  The filename specified by *filename* is used to "
"construct the code object and may appear in tracebacks or :exc:`SyntaxError` "
"exception messages.  This returns ``NULL`` if the code cannot be parsed or "
"compiled."
"Analisa e compila o código-fonte Python em *str*, retornando o objeto de "
"código resultante. O símbolo inicial é fornecido por *start*; isso pode ser "
"usado para restringir o código que pode ser compilado e deve ser :ref:"
"`símbolos iniciais disponíveis <start-symbols>`. O nome do arquivo "
"especificado por *filename* é usado para construir o objeto de código e pode "
"aparecer em tracebacks ou mensagens de exceção :exc:`SyntaxError`. Isso "
"retorna ``NULL`` se o código não puder ser analisado ou compilado."
#: ../../c-api/veryhigh.rst:249
"The integer *optimize* specifies the optimization level of the compiler; a "
"value of ``-1`` selects the optimization level of the interpreter as given "
"by :option:`-O` options.  Explicit levels are ``0`` (no optimization; "
"``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) "
"or ``2`` (docstrings are removed too)."
"O inteiro *optimize* especifica o nível de otimização do compilador; um "
"valor de ``-1`` seleciona o nível de otimização do interpretador dado pela "
"opção :option:`-O`. Níveis explícitos são ``0`` (nenhuma otimização; "
"``__debug__`` é verdadeiro), ``1`` (instruções ``assert`` são removidas, "
"``__debug__`` é falso) ou ``2`` (strings de documentação também são "
"removidas)."
#: ../../c-api/veryhigh.rst:260
"Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string "
"decoded from the :term:`filesystem encoding and error handler`."
"Como :c:func:`Py_CompileStringObject`, mas *filename* é uma string de bytes "
"decodificada a partir do :term:`tratador de erros e codificação do sistema "
"de arquivos`."
#: ../../c-api/veryhigh.rst:267
"This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the "
"code object, and global and local variables.  The other arguments are set to "
"``NULL``."
"Esta é uma interface simplificada para :c:func:`PyEval_EvalCodeEx`, com "
"apenas o objeto código e variáveis locais e globais. Os outros argumentos "
"são definidos como ``NULL``."
#: ../../c-api/veryhigh.rst:274
"Evaluate a precompiled code object, given a particular environment for its "
"evaluation.  This environment consists of a dictionary of global variables, "
"a mapping object of local variables, arrays of arguments, keywords and "
"defaults, a dictionary of default values for :ref:`keyword-only <keyword-"
"only_parameter>` arguments and a closure tuple of cells."
"Avalia um objeto código pré-compilado, dado um ambiente particular para sua "
"avaliação. Este ambiente consiste em um dicionário de variáveis globais, um "
"objeto mapeamento de variáveis locais, vetores de argumentos, nomeados e "
"padrões, um dicionário de valores padrões para argumentos :ref:`somente-"
"nomeados <keyword-only_parameter>` e uma tupla de clausura de células."
#: ../../c-api/veryhigh.rst:283
"Evaluate an execution frame.  This is a simplified interface to :c:func:"
"`PyEval_EvalFrameEx`, for backward compatibility."
"Avalia um quadro de execução. Esta é uma interface simplificada para :c:func:"
"`PyEval_EvalFrameEx`, para retrocompatibilidade."
#: ../../c-api/veryhigh.rst:289
"This is the main, unvarnished function of Python interpretation.  The code "
"object associated with the execution frame *f* is executed, interpreting "
"bytecode and executing calls as needed.  The additional *throwflag* "
"parameter can mostly be ignored - if true, then it causes an exception to "
"immediately be thrown; this is used for the :meth:`~generator.throw` methods "
"of generator objects."
"Esta é a função principal e sem retoques da interpretação Python. O objeto "
"código associado ao quadro de execução *f* é executado, interpretando "
"bytecode e executando chamadas conforme necessário. O parâmetro adicional "
"*throwflag* pode ser ignorado na maioria das vezes - se verdadeiro, ele faz "
"com que uma exceção seja levantada imediatamente; isso é usado para os "
"métodos :meth:`~generator.throw` de objetos geradores."
#: ../../c-api/veryhigh.rst:296
"This function now includes a debug assertion to help ensure that it does not "
"silently discard an active exception."
"Essa função agora inclui uma asserção de depuração para ajudar a garantir "
"que ela não descarte silenciosamente uma exceção ativa."
#: ../../c-api/veryhigh.rst:303
"This function changes the flags of the current evaluation frame, and returns "
"true on success, false on failure."
"Esta função altera os sinalizadores do quadro de avaliação atual e retorna "
"verdadeiro em caso de sucesso e falso em caso de falha."
#: ../../c-api/veryhigh.rst:309
"This is the structure used to hold compiler flags.  In cases where code is "
"only being compiled, it is passed as ``int flags``, and in cases where code "
"is being executed, it is passed as ``PyCompilerFlags *flags``.  In this "
"case, ``from __future__ import`` can modify *flags*."
"Esta é a estrutura usada para manter os sinalizadores do compilador. Em "
"casos onde o código está apenas sendo compilado, ele é passado como ``int "
"flags``, e em casos onde o código está sendo executado, ele é passado como "
"``PyCompilerFlags *flags``. Neste caso, ``from __future__ import`` pode "
"modificar *flags*."
#: ../../c-api/veryhigh.rst:314
"Whenever ``PyCompilerFlags *flags`` is ``NULL``, :c:member:`~PyCompilerFlags."
"cf_flags` is treated as equal to ``0``, and any modification due to ``from "
"__future__ import`` is discarded."
"Sempre que ``PyCompilerFlags *flags`` for ``NULL``, :c:member:"
"`~PyCompilerFlags.cf_flags` é tratado como igual a ``0``, e qualquer "
"modificação devido a ``from __future__ import`` é descartada."
#: ../../c-api/veryhigh.rst:320
msgid "Compiler flags."
msgstr "Sinalizadores do compilador."
#: ../../c-api/veryhigh.rst:324
"*cf_feature_version* is the minor Python version. It should be initialized "
"to ``PY_MINOR_VERSION``."
"*cf_feature_version* é a versão secundária do Python. Deve ser inicializada "
"como ``PY_MINOR_VERSION``."
#: ../../c-api/veryhigh.rst:327
"The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` "
"flag is set in :c:member:`~PyCompilerFlags.cf_flags`."
"O campo é ignorado por padrão, ele é usado se e somente se o sinalizador "
"``PyCF_ONLY_AST`` estiver definido em :c:member:`~PyCompilerFlags.cf_flags`."
#: ../../c-api/veryhigh.rst:330
msgid "Added *cf_feature_version* field."
msgstr "Adicionado campo *cf_feature_version*."
#: ../../c-api/veryhigh.rst:333
msgid "The available compiler flags are accessible as macros:"
msgstr "Os sinalizadores do compilador disponíveis são acessíveis como macros:"
#: ../../c-api/veryhigh.rst:342
"See :ref:`compiler flags <ast-compiler-flags>` in documentation of the :py:"
"mod:`!ast` Python module, which exports these constants under the same names."
"Veja :ref:`sinalizadores do compilador <ast-compiler-flags>` na documentação "
"do módulo Python :py:mod:`!ast`, que exporta essas constantes com os mesmos "
#: ../../c-api/veryhigh.rst:347
msgid "Low-level flags"
#: ../../c-api/veryhigh.rst:348
"The following flags and masks serve narrow needs of the standard library and "
"interactive interpreters.  Code outside the standard library rarely has a "
"reason to use them.  They are considered implementation details and may "
"change at any time."
#: ../../c-api/veryhigh.rst:355
"This flag is a private interface between the compiler and the :mod:`codeop` "
"module.  Do not use it; its behavior is unsupported and may change without "
#: ../../c-api/veryhigh.rst:359
"With this flag set, when compilation fails because the source text ends "
"where more input is expected, for example in the middle of an indented block "
"or an unterminated string literal, the error raised is the undocumented "
"``_IncompleteInputError``, a subclass of :exc:`SyntaxError`.  The :mod:"
"`codeop` module sets this flag, together with :c:macro:"
"`PyCF_DONT_IMPLY_DEDENT`, to tell input that is incomplete apart from input "
"with a real syntax error, so that interactive interpreters know when to "
"prompt for another line instead of reporting an error."
#: ../../c-api/veryhigh.rst:373
"By default, when compiling with the :c:var:`Py_single_input` start symbol, "
"reaching the end of the source text implicitly closes any open indented "
"blocks.  With this flag set, open blocks are only closed if the last line of "
"the source ends with a newline; otherwise, compilation fails with a :exc:"
"`SyntaxError`:"
#: ../../c-api/veryhigh.rst:379
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"const char *source = \"if a:\\n    pass\";\n"
"/* The \"if\" block is closed implicitly;\n"
"   this returns a code object: */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);\n"
"/* With the flag, this fails with a SyntaxError,\n"
"   because the last line does not end with a newline: */\n"
"flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);"
#: ../../c-api/veryhigh.rst:396
"The :mod:`codeop` module uses this flag to detect incomplete interactive "
"input.  While the user is still typing inside an indented block, the source "
"does not yet end with a newline, so it fails to compile and the user is "
"prompted for another line."
#: ../../c-api/veryhigh.rst:403
"Read the source text as UTF-8, ignoring its :pep:`263` encoding declaration "
"(\"coding cookie\"), if any:"
#: ../../c-api/veryhigh.rst:406
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"const char *source = \"# coding: latin-1\\ns = '\\xe9'\\n\";\n"
"/* The coding cookie is honored: byte 0xE9 is decoded as\n"
"   Latin-1, and this returns a code object that sets s to \"é\": */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);\n"
"/* With the flag, the cookie is ignored and compilation fails\n"
"   with a SyntaxError, because 0xE9 is not valid UTF-8: */\n"
"flags.cf_flags = PyCF_IGNORE_COOKIE;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);"
#: ../../c-api/veryhigh.rst:423
"The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set "
"this flag when the source is a :class:`str` object, because they pass the "
"text to the parser encoded as UTF-8."
#: ../../c-api/veryhigh.rst:429
"Mark the source text as known to be UTF-8 encoded. The :func:`compile`, :"
"func:`eval` and :func:`exec` built-in functions set this flag, but it "
"currently has no effect."
#: ../../c-api/veryhigh.rst:433
"The \"``PyCF``\" flags above can be combined with \"``CO_FUTURE``\" flags "
"such as :c:macro:`CO_FUTURE_ANNOTATIONS` to enable features normally "
"selectable using :ref:`future statements <future>`. See :ref:"
"`c_codeobject_flags` for a complete list."
"Os sinalizadores \"``PyCF``\" acima podem ser combinados com sinalizadores "
"\"``CO_FUTURE``\", como :c:macro:`CO_FUTURE_ANNOTATIONS`, para habilitar "
"recursos normalmente selecionáveis usando :ref:`instruções future <future>`. "
"Consulte :ref:`c_codeobject_flags` para obter uma lista completa."
#: ../../c-api/veryhigh.rst:438
msgid "The following masks combine several flags:"
#: ../../c-api/veryhigh.rst:442
"Bitmask of all ``CO_FUTURE`` flags (see :ref:`c_codeobject_flags`), which "
"select features normally enabled by :ref:`future statements <future>`. When "
"code compiled with a ``PyCompilerFlags *flags`` argument contains a ``from "
"__future__ import`` statement, the flag for the imported feature is added to "
"*flags*, so that code executed later in the same context inherits it."
#: ../../c-api/veryhigh.rst:452
"Do not use this mask in new code.  It is kept only so that old code passing "
"its flags to :func:`compile` keeps working."
#: ../../c-api/veryhigh.rst:455
"Bitmask of flags for obsolete future features that no longer have any effect."
#: ../../c-api/veryhigh.rst:460
"Bitmask of all ``PyCF`` flags that change how the source is compiled, such "
"as :c:macro:`PyCF_ONLY_AST`. The :func:`compile` built-in function uses this "
"mask to validate its *flags* argument."
#: ../../c-api/veryhigh.rst:469
msgid "Available start symbols"
msgstr "Símbolos iniciais disponíveis"
#: ../../c-api/veryhigh.rst:476
"The start symbol from the Python grammar for isolated expressions; for use "
"with :c:func:`Py_CompileString`."
"O símbolo inicial da gramática Python para expressões isoladas; para uso "
"com :c:func:`Py_CompileString`."
#: ../../c-api/veryhigh.rst:484
"The start symbol from the Python grammar for sequences of statements as read "
"from a file or other source; for use with :c:func:`Py_CompileString`.  This "
"is the symbol to use when compiling arbitrarily long Python source code."
"O símbolo de início da gramática Python para sequências de instruções "
"conforme lidas de um arquivo ou outra fonte; para uso com :c:func:"
"`Py_CompileString`. Este é o símbolo a ser usado ao compilar código-fonte "
"Python arbitrariamente longo."
#: ../../c-api/veryhigh.rst:493
"The start symbol from the Python grammar for a single statement; for use "
"with :c:func:`Py_CompileString`. This is the symbol used for the interactive "
"interpreter loop."
"O símbolo de início da gramática Python para uma única declaração; para uso "
"com :c:func:`Py_CompileString`. Este é o símbolo usado para o laço do "
"interpretador interativo."
#: ../../c-api/veryhigh.rst:502
"The start symbol from the Python grammar for a function type; for use with :"
"c:func:`Py_CompileString`. This is used to parse \"signature type comments\" "
"from :pep:`484`."
"O símbolo inicial da gramática Python para um tipo de função; para uso com :"
"c:func:`Py_CompileString`. É usado para analisar \"comentários de tipo de "
"assinatura\" de :pep:`484`."
#: ../../c-api/veryhigh.rst:506
msgid "This requires the :c:macro:`PyCF_ONLY_AST` flag to be set."
msgstr "Isso requer que o sinalizador :c:macro:`PyCF_ONLY_AST` seja definido."
#: ../../c-api/veryhigh.rst:509
msgid ":py:class:`ast.FunctionType`"
msgstr ":py:class:`ast.FunctionType`"
#: ../../c-api/veryhigh.rst:510
msgid ":pep:`484`"
msgstr ":pep:`484`"
#: ../../c-api/veryhigh.rst:516
msgid "Stack Effects"
#: ../../c-api/veryhigh.rst:519
msgid ":py:func:`dis.stack_effect`"
#: ../../c-api/veryhigh.rst:524
msgid "Sentinel value representing an invalid stack effect."
#: ../../c-api/veryhigh.rst:526
msgid "This is currently equivalent to ``INT_MAX``."
#: ../../c-api/veryhigh.rst:533
msgid "Compute the stack effect of *opcode* with argument *oparg*."
msgstr "Calcula o efeito que o *opcode* com argumento *oparg* tem na pilha."
#: ../../c-api/veryhigh.rst:535 ../../c-api/veryhigh.rst:549
"On success, this function returns the stack effect; on failure, this "
"returns :c:macro:`PY_INVALID_STACK_EFFECT`."
#: ../../c-api/veryhigh.rst:543
"Similar to :c:func:`PyCompile_OpcodeStackEffect`, but don't include the "
"stack effect of jumping if *jump* is zero."
#: ../../c-api/veryhigh.rst:546
"If *jump* is ``0``, this will not include the stack effect of jumping, but "
"if *jump* is ``1`` or ``-1``, this will include it."
#: ../../c-api/veryhigh.rst:474 ../../c-api/veryhigh.rst:482
#: ../../c-api/veryhigh.rst:491 ../../c-api/veryhigh.rst:500
msgid "Py_CompileString (C function)"
msgstr "Py_CompileString (função C)"
Navigation Menu

Uh oh!

Uh oh!

Uh oh!

Uh oh!

FilesExpand file tree

veryhigh.po

Latest commit

History

veryhigh.po

File metadata and controls
