Constantes embutidas¶
Um pequeno número de constantes são definidas no espaço de nomes embutido da linguagem. São elas:
- False¶
O valor falso do tipo
bool. As atribuições aFalsesão ilegais e levantamSyntaxError.
- True¶
O valor verdadeiro do tipo
bool. As atribuições aTruesão ilegais e levantamSyntaxError.
- None¶
Um objeto frequentemente usado para representar a ausência de um valor, como quando os argumentos padrões não são passados para uma função. As atribuições a
Nonesão ilegais e levantamSyntaxError.Noneé a única instância do tipoNoneType.
- NotImplemented¶
Um valor especial que deve ser retornado pelos métodos binários especiais (por exemplo:
__eq__(),__lt__(),__add__(),__rsub__(), etc.) não é implementado em relação ao outro tipo; pode ser retornado pelos métodos especiais binários no local (por exemplo:__imul__(),__iand__(), etc.) para o mesmo propósito. Ele não deve ser avaliado em um contexto booleano.NotImplementedé a única instância do tipotypes.NotImplementedType.Nota
Quando um método binário (ou local) retorna
NotImplemented, o interpretador tentará a operação refletida no outro tipo (ou algum outro fallback, dependendo do operador). Se todas as tentativas retornaremNotImplemented, o interpretador levantará uma exceção apropriada. Retornar incorretamenteNotImplementedresultará em uma mensagem de erro enganosa ou no valorNotImplementedsendo retornado ao código Python.Consulte Implementando as operações aritméticas para ver exemplos.
Cuidado
NotImplementedeNotImplementedErrornão são intercambiáveis. Esta constante deve ser usada somente conforme descrito acima; vejaNotImplementedErrorpara detalhes sobre o uso correto da exceção.Alterado na versão 3.9: A avaliação de
NotImplementedem um contexto booleano foi descontinuada.Alterado na versão 3.14: A avaliação de
NotImplementedem um contexto booleano agora levanta umTypeError. Anteriormente, ele era avaliado comoTruee emitia umDeprecationWarningdesde o Python 3.9.
- Ellipsis¶
O mesmo que o literal de reticências “
...”, um objeto frequentemente usado para indicar que algo foi omitido. A atribuição aEllipsisé possível, mas a atribuição a...levanta umSyntaxError.Ellipsisé a única instância do tipotypes.EllipsisType.
- __debug__¶
Esta constante é verdadeira se o Python não foi iniciado com uma opção
-O. Veja também a instruçãoassert.
Nota
Os nomes None, False, True e __debug__ não podem ser reatribuídos (atribuições a eles, mesmo como um nome de atributo, levantam SyntaxError ), para que possam ser consideradas “verdadeiras” constantes.
Constantes adicionadas pelo módulo site¶
O módulo site (que é importado automaticamente durante a inicialização, exceto se a opção de linha de comando -S for fornecida) adiciona várias constantes ao espaço de nomes embutido. Eles são úteis para o console do interpretador interativo e não devem ser usados em programas.
- quit(code=None)¶
- exit(code=None)¶
Objetos que, quando exibidos, exibem uma mensagem como “Use quit() or Ctrl-D (i.e. EOF) to exit” e, quando acessados diretamente no interpretador interativo ou chamados como funções, levantam
SystemExitcom o código de saída especificado.
- help
Objeto que, quando exibido, exibe a mensagem “Type help() for interactive help, or help(object) for help about object.” e, quando acessado diretamente no interpretador interativo, invoca o sistema de ajuda embutido (veja
help()).
- copyright¶
- credits¶
Objetos que ao serem impressos ou chamados, imprimem o texto dos direitos autorais ou créditos, respectivamente.
- license¶
Objeto que, quando impresso, imprime a mensagem “Type license() to see the full license text” e, quando chamado, exibe o texto completo da licença de maneira semelhante a um paginador (uma tela por vez).