Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

La unión de tipos `X | None`

`X | None` describe un valor de tipo `X` o el valor `None`. En `-> str | None` indica qué puede devolver una función, no un valor predeterminado.

Versión: Python 3.12

Sintaxis

X | None

En Python 3.12, X | None une el tipo X con el tipo cuyo único valor es None. Esta sintaxis está disponible desde Python 3.10. En str | None, | construye una unión de tipos; no aplica una operación OR bit a bit a dos enteros. Como anotación de tipo, X | None equivale a typing.Optional[X] y a typing.Union[X, None].

La anotación del parámetro value: str | None permite pasar None, pero no omitir el argumento: no se ha indicado un valor predeterminado. Con value: str | None = None también se establece un valor predeterminado. Python no comprueba por sí mismo estas anotaciones durante la ejecución.

En el ejemplo, -> str | None describe el resultado de la función auxiliar parse_args. El método argparse.ArgumentParser.parse_args devuelve un argparse.Namespace, mientras que la función auxiliar solo devuelve su atributo profile. Comprueba profile is None antes de usar métodos de cadena: '' sigue siendo una cadena y no indica que falte un valor.

Ejemplos

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: ''

Las tres llamadas muestran la opción `--profile` omitida, el valor `'dev'` y una cadena vacía `''` proporcionada explícitamente.

Lecciones relacionadas

  • Python · Lección 34 · Avanzado · Versión: 5

Fuentes