Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 | None

Em 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

Fontes