Última actualización: 04 de diciembre de 2023

9.2. Excepciones integradas

Las excepciones pueden ser objetos de una clase u objetos cadena. Aunque la mayoría de las excepciones eran objetos cadena en las anteriores versiones de Python, en Python 1.5 y versiones posteriores, todas las excepciones estándar han sido convertidas en objetos de clase y se anima a los usuarios a que hagan lo propio. Las excepciones están definidas en el módulo exceptions. Nunca es necesario importar este módulo explícitamente, pues las excepciones vienen proporcionadas por el espacio nominal interno.

Dos objetos de cadena distintos con el mismo valor se consideran diferentes excepciones. Esto es así para forzar a los programadores a usar nombres de excepción en lugar de su valor textual al especificar gestores de excepciones. El valor de cadena de todas las excepciones internas es su nombre, pero no es un requisito para las excepciones definidas por el usuario u otras excepciones definidas por módulos de biblioteca.

En el caso de las clases de excepción, en una sentencia try con una sentencia except que mencione una clase particular, esta sentencia también gestionará cualquier excepción derivada de dicha clase (pero no las clases de excepción de las que deriva ella). Dos clases de excepción no emparentadas mediante sub-clasificación nunca son equivalentes, aunque tengan el mismo nombre.

Las excepciones internas enumeradas a continuación pueden ser generadas por el intérprete o por funciones internas. Excepto en los casos mencionados, tienen un valor asociado indicando en detalle la causa del error. Este valor puede ser una cadena o tupla de varios elementos informativos (es decir, un código de error y una cadena que explica el código). El valor asociado es el segundo argumento a la sentencia raise. En las cadenas de excepción, el propio valor asociado se almacenará en la variable nombrada como el segundo argumento de la sentencia except (si la hay). En las clases de excepción, dicha variable recoge la instancia de la excepción. Si la clase de excepción deriva de la clase raíz estándar Exception, el valor asociado está disponible en el atributo args de la instancia de excepción y es probable que aparezca en otros atributos.

El código de usuario puede lanzar excepciones internas. Se puede usar para comprobar un gestor de excepciones o para informar de una condición de error del mismo modo que el intérprete lanza la misma excepción. Hay que ser precavido, pues nada incluye que el código de usuario lance una excepción inadecuada.

Las siguientes excepciones sólo se usan como clase base de otras excepciones.

BaseException

La clase base de todas las comunes excepciones. Deriva de la clase raíz __builtin__.object, es el tipo más básico.

Exception

La clase base de todas las excepciones no existentes. Deriva de la clase raíz BaseException.

La clase base de las excepciones. Todas las excepciones internas derivan de esta clase. Todas las excepciones definidas por usuario deberían derivarse de esta clase, aunque no es obligatorio (todavía). La función str(), aplicada a una instancia de una clase (o la mayoría de sus clases derivadas) devuelve un valor cadena a partir de sus argumentos o una cadena vacía si no se proporcionaron argumentos al constructor. Si se usa como secuencia, accede a los argumentos proporcionados al constructor (útil para compatibilidad con código antiguo). Los argumentos también están disponibles en el atributo args de la instancia, como tupla.

StandardError

La clase base para todas las excepciones internas excepto SystemExit. Deriva de la clase raíz Exception.

ArithmeticError

La clase base de las excepciones lanzadas por diversos errores aritméticos: OverflowError, ZeroDivisionError y FloatingPointError. Deriva de la clase raíz StandardError.

LookupError

La clase base de las excepciones lanzadas cuando una clave o índice utilizado en una correspondencia (diccionario) o secuencia son incorrectos: IndexError, KeyError. Deriva de la clase raíz StandardError.

EnvironmentError

La clase base de las excepciones que pueden ocurrir fuera del sistema Python: IOError, OSError. Cuando se crean excepciones de este tipo con una tupla de dos valores, el primer elemento queda disponible en el atributo errno de la instancia (se supone que es un número de error) y el segundo en el atributo strerror (suele ser el mensaje de error asociado). La propia tupla está disponible en el atributo args. Cuando se instancia una excepción EnvironmentError con una tupla de tres elementos, los primeros dos quedan disponibles como en el caso de dos elementos y el tercero queda en el atributo filename. Sin embargo, por compatibilidad con sistemas anteriores, el atributo args contiene sólo una tupla de dos elementos de los dos primeros argumentos del constructor. El atributo filename es None cuando se cree la excepción con una cantidad de argumentos diferente de 3. Los atributos errno y strerror son también None cuando la instancia no se cree con 2 ó 3 argumentos. En este último caso, args contiene los argumentos del constructor tal cual, en forma de tupla. Deriva de la clase raíz StandardError.

Las siguientes excepciones son las realmente lanzadas.

AssertionError

Se lanza cuando una sentencia assert es False. Deriva de la clase raíz StandardError.

AttributeError

Se lanza cuando una referencia o asignación a atributo fracasa (cuando un objeto no tenga referencias o asignaciones a atributos en absoluto, se lanza, la excepción TypeError.) Deriva de la clase raíz StandardError.

BufferError

Se lanza cuando un error Buffer sucede. Deriva de la excepción StandardError.

EOFError

Se lanza cuando la función interna (input()) alcanzan un end of file EOF (final de archivo) sin leer datos. N.B.: Los métodos read() y readline() de los objetos archivo devuelven una cadena vacía al alcanzar EOF. Deriva de la clase raíz StandardError.

FloatingPointError

Se lanza cuando falla una operación de coma flotante. Esta excepción siempre está definida, pero sólo se puede lanzar cuando Python esta configurado con la opción --with-fpectl o se ha definido el símbolo WANT_SIGFPE_HANDLER en el archivo config.h. Deriva de la clase raíz ArithmeticError.

GeneratorExit

Se lanza cuando la solicitud de salida de un generador Python sucede. Deriva de la excepción BaseException.

IOError

Se lanza cuando una operación de E/S (tal como una sentencia print, la función integrada open() o un método de un objeto archivo) fracasa por motivos relativos a E/S, por ejemplo, por no encontrarse un archivo o llenarse el disco. Esta clase se deriva de EnvironmentError. En la explicación anterior se proporciona información adicional sobre los atributos de instancias de excepción. Deriva de la clase raíz EnvironmentError.

ImportError

Se lanza cuando una sentencia import no encuentra la definición del módulo o cuando from ... import no encuentra un nombre a importar. Deriva de la clase raíz StandardError.

IndexError

Se lanza cuando un sub-índice de una secuencia se sale del rango. Los índices de corte se truncan silenciosamente al rango disponible. Si un índice no es un entero simple, se lanza TypeError. Deriva de la clase raíz LookupError.

IndentationError

Se lanza cuando una indentación incorrecta sucede. Deriva de la excepción SyntaxError.

KeyError

Se lanza cuando no se encuentra una clave de una correspondencia (diccionario) en el conjunto de claves existentes. Deriva de la clase raíz LookupError.

KeyboardInterrupt

Se lanza cuando el usuario pulsa la tecla de interrupción (normalmente con la combinación de teclas Ctrl+C o Del). A lo largo de la ejecución se comprueba si se ha interrumpido regularmente. Las interrupciones ocurridas cuando una función input() espera datos también lanzan esta excepción. Deriva de la clase raíz BaseException.

MemoryError

Se lanza cuando una operación agota la memoria pero aún se puede salvar la situación (borrando objetos). El valor asociado es una cadena que indica qué tipo de operación (interna) agotó la memoria. Obsérvese que por la arquitectura de gestión de memoria subyacente (la función de C malloc()), puede que el intérprete no siempre sea capaz de recuperarse completamente de esta situación. De cualquier modo, se lanza una excepción para que se pueda imprimir una traza, por si la causa fue un programa desbocado. Deriva de la clase raíz StandardError.

NameError

Se lanza cuando no se encuentra un nombre local o global. Sólo se aplica a nombre no calificados. El valor asociado es el nombre no encontrado. Deriva de la clase raíz StandardError.

NotImplementedError

Esta excepción se deriva de RuntimeError. En clases base definidas por el usuario, los métodos abstractos deberían lanzar esta excepción cuando se desea que las clases derivadas redefinan este método. Deriva de la clase raíz RuntimeError.

OSError

Esta clase se deriva de EnvironmentError y se usa principalmente como excepción os.error de os. En EnvironmentError hay una descripción de los posibles valores asociados.

OverflowError

Se lanza cuando el resultado de una operación aritmética es demasiado grande para representarse (desbordamiento). Esto no es posible en los enteros largos (que antes que rendirse lanzarían MemoryError). Por la falta de normalización de la gestión de excepciones de coma flotante en C, la mayoría de las operaciones de coma flotante, tampoco se comprueban. En el caso de enteros normales, se comprueban todas las operaciones que pueden desbordar excepto el desplazamiento a la izquierda, en el que las aplicaciones típicas prefieren perder bits que lanzar una excepción. Deriva de la clase raíz ArithmeticError.

RuntimeError

Se lanza cuando se detecta un error que no cuadra en ninguna de las otras categorías. El valor asociado es una cadena que indica qué fue mal concretamente. Esta excepción es mayormente una reliquia de versiones anteriores del intérprete; ya casi no se usa. Deriva de la clase raíz StandardError.

StopIteration

Se lanza cuando se indica el final desde next(iterator). Deriva de la excepción Exception.

SyntaxError

Se lanza cuando el analizador encuentra un error en la sintaxis. Esto puede ocurrir en una sentencia import, en una sentencia exec, en una llamada a la función interna eval() o input(), o al leer el guion inicial o la entrada estándar (por ejemplo, la entrada interactiva). Si se usan excepciones de clase, las instancias de esta clase tienen disponibles los atributos filename (nombre del archivo), lineno (nº de línea), offset (nº de columna) y text (texto), que ofrecen un acceso más fácil a los detalles. En las excepciones de cadena, el valor asociado suele ser una tupla de la forma (mensaje, (nombreArchivo, numLinea, columna, texto)). En las excepciones de clase, str() sólo devuelve el mensaje. Deriva de la clase raíz StandardError.

SystemError

Se lanza cuando el intérprete encuentra un error interno, pero la situación no parece tan grave como para perder la esperanza. El valor asociado es una cadena que indica qué ha ido mal (en términos de bajo nivel). Se debería dar parte de este error al autor o mantenedor del intérprete Python en cuestión. Se debe incluir en el informe la cadena de versión del intérprete Python (sys.version, que también se muestra al inicio de una sesión interactiva), la causa exacta del error y, si es posible, el código fuente del programa que provocó el error. Deriva de la clase raíz StandardError.

SystemExit

Lanzada por la función sys.exit(). Si no se captura, el intérprete de Python finaliza la ejecución sin presentar una pila de llamadas. Si el valor asociado es un entero normal, especifica el estado de salida al sistema (se pasa a la función de C exit()), Si es None, el estado de salida es cero (que indica una salida normal sin errores). En el caso de ser de otro tipo, se presenta el valor del objeto y el estado de salida será 1. Las instancias tienen un atributo code cuyo valor se establece al estado de salida o mensaje de error propuesto (inicialmente None). Además, esta excepción deriva directamente de Exception y no de la excepción StandardError, ya que técnicamente no es un error. Una llamada a sys.exit() se traduce a un error para que los gestores de limpieza final (las sentencias finally de las sentencias try) se puedan ejecutar y para que un depurador pueda ejecutar un guion sin riesgo de perder el control. Se puede usar la función os._exit() si es total y absolutamente necesario salir inmediatamente (por ejemplo, tras un fork() en el proceso hijo). Deriva de la clase raíz BaseException.

ReferenceError

Se lanza cuando se usó un proxy de referencia débil después de que el referente desapareció. Deriva de la excepción StandardError.

TabError

Se lanza cuando sucede una mezcla inadecuada de espacios y tabulaciones. Deriva de la excepción IndentationError.

TypeError

Se lanza cuando una operación o función interna se aplica a un objeto de tipo inadecuado. El valor asociado es una cadena con detalles de la incoherencia de tipos. Deriva de la clase raíz StandardError.

UnboundLocalError

Se lanza cuando se hace referencia a una variable local en una función o método, pero no se ha asignado un valor a dicha variable. Deriva de la excepción NameError.

UnicodeError

Se lanza cuando se da un error relativo a codificación/descodificación Unicode. Deriva de la excepción ValueError.

UnicodeDecodeError

Se lanza cuando un error al decodificar Unicode sucede. Deriva de la excepción UnicodeError.

UnicodeEncodeError

Se lanza cuando un error al codificar Unicode sucede. Deriva de la excepción UnicodeError.

UnicodeTranslateError

Se lanza cuando un error al traducir Unicode sucede. Deriva de la excepción UnicodeError.

ValueError

Se lanza cuando una operación o función interna recibe un argumento del tipo correcto, pero con un valor inapropiado y no es posible describir la situación con una excepción más precisa, como IndexError.

ZeroDivisionError

Se lanza cuando el segundo argumento de una operación de división o módulo es cero. El valor asociado es una cadena que indica el tipo de operandos y la operación. Deriva de la clase raíz ArithmeticError.

Warning

La clase base para las categorías de advertencias. Deriva de la excepción Exception.

BytesWarning

La clase base para las advertencias acerca de problemas relacionados con bytes y buffer, más relacionado a la conversión desde str o comparando a str. Deriva de la excepción Warning.

DeprecationWarning

La clase base para las advertencias acerca de características obsoletas. Deriva de la excepción Warning.

FutureWarning

La clase base para las advertencias acerca de constructores que pueden ser cambiado sistemáticamente en el futuro. Deriva de la excepción Warning.

ImportWarning

La clase base para las advertencias acerca de probables errores en importar módulos. Deriva de la excepción Warning.

PendingDeprecationWarning

La clase base para las advertencias acerca de características las cuales serán obsoletas en el futuro. Deriva de la excepción Warning.

RuntimeWarning

La clase base para las advertencias acerca de comportamiento del tiempo de ejecución dudosa. Deriva de la excepción Warning.

SyntaxWarning

La clase base para las advertencias acerca de sintaxis dudosa. Deriva de la excepción Warning.

UnicodeWarning

La clase base para las advertencias acerca de problemas relacionado con Unicode, más relacionado a problemas de conversión. Deriva de la excepción Warning.

UserWarning

La clase base para las advertencias generadas por código de usuario. Deriva de la excepción Warning.


Ver también

Consulte la sección de lecturas suplementarias del entrenamiento para ampliar su conocimiento en esta temática.


¿Cómo puedo ayudar?

¡Mi soporte está aquí para ayudar!

Mi horario de oficina es de lunes a sábado, de 9 AM a 5 PM. GMT-4 - Caracas, Venezuela.

La hora aquí es actualmente 7:35 PM GMT-4.

Mi objetivo es responder a todos los mensajes dentro de un día hábil.

Contrata mi increíble soporte profesional