CKTIS / Python
A união de tipos `X | None`
`X | None` descreve um valor do tipo `X` ou o valor `None`. Em `-> str | None`, descreve o valor devolvido por uma função, não um valor predefinido.
Versão: Python 3.12
Sintaxe
X | NoneEm Python 3.12, X | None une o tipo X ao tipo cujo único valor é None. Esta sintaxe está disponível desde Python 3.10. Em str | None, o operador | constrói uma união de tipos; não efectua uma operação OU bit a bit sobre inteiros. Como anotação de tipo, X | None equivale a typing.Optional[X] e a typing.Union[X, None].
A anotação do parâmetro value: str | None permite passar None, mas não omitir o argumento: não foi indicado nenhum valor predefinido. A escrita value: str | None = None também define um valor predefinido. O Python não verifica por si só estas anotações durante a execução.
No exemplo, -> str | None descreve o valor devolvido pela função auxiliar parse_args. O método argparse.ArgumentParser.parse_args devolve um argparse.Namespace, mas a função auxiliar devolve apenas o seu atributo profile. Verifica profile is None antes de usares métodos de cadeias de caracteres: '' continua a ser uma cadeia de caracteres e não indica a ausência de um valor.
Exemplos
import argparse
def parse_args(argv: list[str]) -> str | None:
parser = argparse.ArgumentParser()
parser.add_argument("--profile", default=None)
return parser.parse_args(argv).profile
for argv in ([], ["--profile", "dev"], ["--profile="]):
profile = parse_args(argv)
if profile is None:
print("No profile provided")
else:
print(f"Profile: {profile!r}")
Resultado
No profile provided Profile: 'dev' Profile: ''
As três chamadas mostram a opção `--profile` omitida, o valor `'dev'` e uma cadeia de caracteres vazia `''` fornecida explicitamente.
Lições relacionadas
- Python · Lição 34 · Avançado · Versão: 5