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