I have just read a bunch of posts on how to handle the StopIteration error in Python, I had trouble solving my particular example.I just want to print out from 1 to 20 with my code but it prints out error StopIteration. My code is:(I am a completely newbie here so please don’t block me.)
def simpleGeneratorFun(n):
while n<20:
yield (n)
n=n+1
# return [1,2,3]
x = simpleGeneratorFun(1)
while x.__next__() <20:
print(x.__next__())
if x.__next__()==10:
break
dreftymac
31.2k26 gold badges119 silver badges181 bronze badges
asked Apr 27, 2018 at 19:48
Any time you use x.__next__() it gets the next yielded number — you do not check every one yielded and 10 is skipped — so it continues to run after 20 and breaks.
Fix:
def simpleGeneratorFun(n):
while n<20:
yield (n)
n=n+1
# return [1,2,3]
x = simpleGeneratorFun(1)
while True:
try:
val = next(x) # x.__next__() is "private", see @Aran-Frey comment
print(val)
if val == 10:
break
except StopIteration as e:
print(e)
break
answered Apr 27, 2018 at 19:55
Patrick ArtnerPatrick Artner
50.2k8 gold badges42 silver badges69 bronze badges
4
First, in each loop iteration, you’re advancing the iterator 3 times by making 3 separate calls to __next__(), so the if x.__next__()==10 might never be hit since the 10th element might have been consumed earlier. Same with missing your while condition.
Second, there are usually better patterns in python where you don’t need to make calls to next directly. For example, if you have finite iterator, use a for loop to automatically break on StopIteration:
x = simpleGeneratorFun(1)
for i in x:
print i
answered Apr 27, 2018 at 19:59
jlaujlau
3661 silver badge4 bronze badges
1
By Lenin Mishra
in
python
—
Jan 22, 2022
Handle StopIteration error in Python using the try-except block.
To understand StopIteration Exception, you need to understand how iterators work in Python.
- Iterator is an object that holds values which can be iterated upon.
- It uses the
__next__()method to move to the next value in the iterator. - When the
__next__()method tries to move to the next value, but there are no new values, aStopIterationException is raised.
Example 1
Code
y = [1, 2, 3]
x = iter(y)
print(x.__next__())
print(x.__next__())
print(x.__next__())
print(x.__next__())
Output
1
2
3
Traceback (most recent call last):
File "some_file_location", line 6, in <module>
print(x.__next__())
StopIteration
You can catch such errors using the StopIteration Exception class.
Example 2
Code
y = [1, 2, 3]
x = iter(y)
try:
print(x.__next__())
print(x.__next__())
print(x.__next__())
print(x.__next__())
except StopIteration as e:
print("StopIteration error handled successfully")
Output
1
2
3
StopIteration error handled successfully
Check out other Python Built-in Exception classes in Python.
built-in-exception-classes — Pylenin
A programmer who aims to democratize education in the programming world and help his peers achieve the career of their dreams.
Introduction to Python StopIteration
The following article outlines Python StopIteration as we know the topic ‘iterator’ and ‘iterable’ in Python. The basic idea of what the ‘iterator’ is? An iterator is an object that holds a value (generally a countable number) that is iterated upon. Iterator in Python uses the __next__() method to traverse to the next value. To tell that no more deals need to be traversed by the __next__() process, a StopIteration statement is used. Programmers usually write a terminating condition inside the __next__() method to stop it after reaching the specified state.
Syntax of Python StopIteration
When the method used for iterators and generators completes a specified number of iterations, it raises the StopIteration exception. It’s important to note that Python treats raising StopIteration as an exception rather than a mistake. Like how Python handles other exceptions, this exception can be handled by catching it. This active handling of the StopIteration exception allows for proper control and management of the iteration process, ensuring that the code can gracefully handle the termination of the iteration when required.
The general syntax of using StopIteration in if and else of next() method is as follows:
class classname:
def __iter__(self):
…
… #set of statements
return self;
def __next__(self):
if …. #condition till the loop needs to be executed
…. #set of statements that needs to be performed till the traversing needs to be done
return …
else
raise StopIteration #it will get raised when all the values of iterator are traversed
How StopIteration works in Python?
- It is raised by the method next() or __next__(), a built-in Python method to stop the iterations or to show that no more items are left to be iterated upon.
- We can catch the StopIteration exception by writing the code inside the try block, catching the exception using the ‘except’ keyword, and printing it on screen using the ‘print’ keyword.
- The following () method in both generators and iterators raises it when no more elements are present in the loop or any iterable object.
Examples of Python StopIteration
Given below are the examples mentioned:
Example #1
Stop the printing of numbers after 20 or printing numbers incrementing by 2 till 20 in the case of Iterators.
Code:
class printNum:
def __iter__(self):
self.z = 2
return self
def __next__(self):
if self.z <= 20: #performing the action like printing the value on console till the value reaches 20
y = self.z
self.z += 2
return y
else:
raise StopIteration #raising the StopIteration exception once the value gets increased from 20
obj = printNum()
value_passed = iter(obj)
for u in value_passed:
print(u)
Output:
Explanation:
- In the above example, we use two methods, namely iter() and next(), to iterate through the values. The next() method utilizes if and else statements to check for the termination condition of the iteration actively.
- If the iterable value is less than or equal to 20, it continues to print those values at the increment of 2. Once the value exceeds 20, the next() method raises a StopIteration exception.
Example #2
Finding the cubes of number and stop executing once the value becomes equal to the value passed using StopIteration in the case of generators.
Code:
def values(): #list of integer values with no limits
x = 1 #initializing the value of integer to 1
while True:
yield x
x+= 1
def findingcubes():
for x in values():
yield x * x *x #finding the cubes of value ‘x’
def func(y, sequence):
sequence = iter(sequence)
output = [ ] #creating an output blank array
try:
for x in range(y): #using the range function of python to use for loop
output.append(next(sequence)) #appending the output in the array
except StopIteration: #catching the exception
pass
return output
print(func(5, findingcubes())) #passing the value in the method ‘func’
Output:
Explanation:
- In the above example, we find the cubes of numbers from 1 to the number passed in the function. We generate multiple values at a time using generators in Python, and to stop the execution once the value reaches the one passed in the function, we raise a StopIteration exception.
- We create different methods serving their respective purposes, such as generating the values, finding the cubes, and printing the values by storing them in the output array. The program uses basic Python functions like range and append, which should be clear to the programmer in the initial stages of learning.
How to Avoid StopIteration Exception in Python?
- As seen above StopIteration is not an error in Python but an exception and is used to run the next() method for the specified number of iterations. Iterator in Python uses two methods, i.e. iter() and next().
- The next() method raises a StopIteration exception when the next() method is called manually.
- The best way to avoid this exception in Python is to use normal looping or use it as a normal iterator instead of writing the next() method repeatedly.
- Otherwise, if not able to avoid StopIteration exception in Python, we can simply raise the exception in the next() method and catch the exception like a normal exception in Python using the except keyword.
Conclusion
As discussed above in the article, it must be clear to you what is the StopIteration exception and in which condition it is raised in Python. StopIteration exception could be an issue to deal with for the new programmers as it can be raised in many situations.
Recommended Articles
This is a guide to Python StopIteration. Here we discuss how StopIteration works in Python and how to avoid StopIteration exceptions with programming examples. You may also have a look at the following articles to learn more –
- Python Regex Tester
- Python Rest Server
- Python String Operations
- Python Counter
In Python, StopIteration is an exception which occurred by built-in next() and __next__() method in iterator to signal that iteration is done for all items and no more to left to iterate.
Example of StopIteration
In this example string value “FacingIssuesOnIT” is Iterating to print character. In this case while loop will run indefinitely and call next() method on iterable value to print value.
iterable_value = 'FacingIssuesOnIT'
iterable_obj = iter(iterable_value)
while True:
try:
# Iterate by calling next
item = next(iterable_obj)
print(item)
except StopIteration as err:
print('Stop Iteration occured')
break
Output
F a c i n g I s s u e s O n I T Stop Iteration occurred
In this program after completing the iteration next() element print of iterable_value when it goes to next element print it will throw StopIteration exception because there is no more element in iterable_value.
Solution
Whenever you apply the next() method of iterable object always check the length of iterable object then run the loop to get element by next() method.
“Learn From Others Experience»
In Python, all exceptions must be instances of a class that derives from
BaseException. In a try statement with an except
clause that mentions a particular class, that clause also handles any exception
classes derived from that class (but not exception classes from which it is
derived). Two exception classes that are not related via subclassing are never
equivalent, even if they have the same name.
The built-in exceptions listed below can be generated by the interpreter or
built-in functions. Except where mentioned, they have an “associated value”
indicating the detailed cause of the error. This may be a string or a tuple of
several items of information (e.g., an error code and a string explaining the
code). The associated value is usually passed as arguments to the exception
class’s constructor.
User code can raise built-in exceptions. This can be used to test an exception
handler or to report an error condition “just like” the situation in which the
interpreter raises the same exception; but beware that there is nothing to
prevent user code from raising an inappropriate error.
The built-in exception classes can be subclassed to define new exceptions;
programmers are encouraged to derive new exceptions from the Exception
class or one of its subclasses, and not from BaseException. More
information on defining exceptions is available in the Python Tutorial under
User-defined Exceptions.
When raising (or re-raising) an exception in an except or
finally clause
__context__ is automatically set to the last exception caught; if the
new exception is not handled the traceback that is eventually displayed will
include the originating exception(s) and the final exception.
When raising a new exception (rather than using a bare raise to re-raise
the exception currently being handled), the implicit exception context can be
supplemented with an explicit cause by using from with
raise:
raise new_exc from original_exc
The expression following from must be an exception or None. It
will be set as __cause__ on the raised exception. Setting
__cause__ also implicitly sets the __suppress_context__
attribute to True, so that using raise new_exc from None
effectively replaces the old exception with the new one for display
purposes (e.g. converting KeyError to AttributeError, while
leaving the old exception available in __context__ for introspection
when debugging.
The default traceback display code shows these chained exceptions in
addition to the traceback for the exception itself. An explicitly chained
exception in __cause__ is always shown when present. An implicitly
chained exception in __context__ is shown only if __cause__
is None and __suppress_context__ is false.
In either case, the exception itself is always shown after any chained
exceptions so that the final line of the traceback always shows the last
exception that was raised.
5.1. Base classes¶
The following exceptions are used mostly as base classes for other exceptions.
-
exception
BaseException¶ -
The base class for all built-in exceptions. It is not meant to be directly
inherited by user-defined classes (for that, useException). If
str()is called on an instance of this class, the representation of
the argument(s) to the instance are returned, or the empty string when
there were no arguments.-
args¶ -
The tuple of arguments given to the exception constructor. Some built-in
exceptions (likeOSError) expect a certain number of arguments and
assign a special meaning to the elements of this tuple, while others are
usually called only with a single string giving an error message.
-
with_traceback(tb)¶ -
This method sets tb as the new traceback for the exception and returns
the exception object. It is usually used in exception handling code like
this:try: ... except SomeException: tb = sys.exc_info()[2] raise OtherException(...).with_traceback(tb)
-
-
exception
Exception¶ -
All built-in, non-system-exiting exceptions are derived from this class. All
user-defined exceptions should also be derived from this class.
-
exception
ArithmeticError¶ -
The base class for those built-in exceptions that are raised for various
arithmetic errors:OverflowError,ZeroDivisionError,
FloatingPointError.
-
exception
BufferError¶ -
Raised when a buffer related operation cannot be
performed.
-
exception
LookupError¶ -
The base class for the exceptions that are raised when a key or index used on
a mapping or sequence is invalid:IndexError,KeyError. This
can be raised directly bycodecs.lookup().
5.2. Concrete exceptions¶
The following exceptions are the exceptions that are usually raised.
-
exception
AssertionError¶ -
Raised when an
assertstatement fails.
-
exception
AttributeError¶ -
Raised when an attribute reference (see Attribute references) or
assignment fails. (When an object does not support attribute references or
attribute assignments at all,TypeErroris raised.)
-
exception
EOFError¶ -
Raised when the
input()function hits an end-of-file condition (EOF)
without reading any data. (N.B.: theio.IOBase.read()and
io.IOBase.readline()methods return an empty string when they hit EOF.)
-
exception
FloatingPointError¶ -
Raised when a floating point operation fails. This exception is always defined,
but can only be raised when Python is configured with the
--with-fpectloption, or theWANT_SIGFPE_HANDLERsymbol is
defined in thepyconfig.hfile.
-
exception
GeneratorExit¶ -
Raised when a generator or coroutine is closed;
seegenerator.close()andcoroutine.close(). It
directly inherits fromBaseExceptioninstead ofExceptionsince
it is technically not an error.
-
exception
ImportError¶ -
Raised when the
importstatement has troubles trying to
load a module. Also raised when the “from list” infrom ... import
has a name that cannot be found.The
nameandpathattributes can be set using keyword-only
arguments to the constructor. When set they represent the name of the module
that was attempted to be imported and the path to any file which triggered
the exception, respectively.Changed in version 3.3: Added the
nameandpathattributes.
-
exception
ModuleNotFoundError¶ -
A subclass of
ImportErrorwhich is raised byimport
when a module could not be located. It is also raised whenNone
is found insys.modules.New in version 3.6.
-
exception
IndexError¶ -
Raised when a sequence subscript is out of range. (Slice indices are
silently truncated to fall in the allowed range; if an index is not an
integer,TypeErroris raised.)
-
exception
KeyError¶ -
Raised when a mapping (dictionary) key is not found in the set of existing keys.
-
exception
KeyboardInterrupt¶ -
Raised when the user hits the interrupt key (normally
Control-Cor
Delete). During execution, a check for interrupts is made
regularly. The exception inherits fromBaseExceptionso as to not be
accidentally caught by code that catchesExceptionand thus prevent
the interpreter from exiting.
-
exception
MemoryError¶ -
Raised when an operation runs out of memory but the situation may still be
rescued (by deleting some objects). The associated value is a string indicating
what kind of (internal) operation ran out of memory. Note that because of the
underlying memory management architecture (C’smalloc()function), the
interpreter may not always be able to completely recover from this situation; it
nevertheless raises an exception so that a stack traceback can be printed, in
case a run-away program was the cause.
-
exception
NameError¶ -
Raised when a local or global name is not found. This applies only to
unqualified names. The associated value is an error message that includes the
name that could not be found.
-
exception
NotImplementedError¶ -
This exception is derived from
RuntimeError. In user defined base
classes, abstract methods should raise this exception when they require
derived classes to override the method, or while the class is being
developed to indicate that the real implementation still needs to be added.Note
It should not be used to indicate that an operator or method is not
meant to be supported at all – in that case either leave the operator /
method undefined or, if a subclass, set it toNone.Note
NotImplementedErrorandNotImplementedare not interchangeable,
even though they have similar names and purposes. See
NotImplementedfor details on when to use it.
-
exception
OSError([arg])¶ -
exception
OSError(errno, strerror[, filename[, winerror[, filename2]]]) -
This exception is raised when a system function returns a system-related
error, including I/O failures such as “file not found” or “disk full”
(not for illegal argument types or other incidental errors).The second form of the constructor sets the corresponding attributes,
described below. The attributes default toNoneif not
specified. For backwards compatibility, if three arguments are passed,
theargsattribute contains only a 2-tuple
of the first two constructor arguments.The constructor often actually returns a subclass of
OSError, as
described in OS exceptions below. The particular subclass depends on
the finalerrnovalue. This behaviour only occurs when
constructingOSErrordirectly or via an alias, and is not
inherited when subclassing.-
errno¶ -
A numeric error code from the C variable
errno.
-
winerror¶ -
Under Windows, this gives you the native
Windows error code. Theerrnoattribute is then an approximate
translation, in POSIX terms, of that native error code.Under Windows, if the winerror constructor argument is an integer,
theerrnoattribute is determined from the Windows error code,
and the errno argument is ignored. On other platforms, the
winerror argument is ignored, and thewinerrorattribute
does not exist.
-
strerror¶ -
The corresponding error message, as provided by
the operating system. It is formatted by the C
functionsperror()under POSIX, andFormatMessage()
under Windows.
-
filename¶ -
filename2¶ -
For exceptions that involve a file system path (such as
open()or
os.unlink()),filenameis the file name passed to the function.
For functions that involve two file system paths (such as
os.rename()),filename2corresponds to the second
file name passed to the function.
Changed in version 3.3:
EnvironmentError,IOError,WindowsError,
socket.error,select.errorand
mmap.errorhave been merged intoOSError, and the
constructor may return a subclass.Changed in version 3.4: The
filenameattribute is now the original file name passed to
the function, instead of the name encoded to or decoded from the
filesystem encoding. Also, the filename2 constructor argument and
attribute was added. -
-
exception
OverflowError¶ -
Raised when the result of an arithmetic operation is too large to be
represented. This cannot occur for integers (which would rather raise
MemoryErrorthan give up). However, for historical reasons,
OverflowError is sometimes raised for integers that are outside a required
range. Because of the lack of standardization of floating point exception
handling in C, most floating point operations are not checked.
-
exception
RecursionError¶ -
This exception is derived from
RuntimeError. It is raised when the
interpreter detects that the maximum recursion depth (see
sys.getrecursionlimit()) is exceeded.New in version 3.5: Previously, a plain
RuntimeErrorwas raised.
-
exception
ReferenceError¶ -
This exception is raised when a weak reference proxy, created by the
weakref.proxy()function, is used to access an attribute of the referent
after it has been garbage collected. For more information on weak references,
see theweakrefmodule.
-
exception
RuntimeError¶ -
Raised when an error is detected that doesn’t fall in any of the other
categories. The associated value is a string indicating what precisely went
wrong.
-
exception
StopIteration¶ -
Raised by built-in function
next()and an iterator‘s
__next__()method to signal that there are no further
items produced by the iterator.The exception object has a single attribute
value, which is
given as an argument when constructing the exception, and defaults
toNone.When a generator or coroutine function
returns, a newStopIterationinstance is
raised, and the value returned by the function is used as the
valueparameter to the constructor of the exception.If a generator function defined in the presence of a
from __future__directive raises
import generator_stopStopIteration, it will be
converted into aRuntimeError(retaining theStopIteration
as the new exception’s cause).Changed in version 3.3: Added
valueattribute and the ability for generator functions to
use it to return a value.Changed in version 3.5: Introduced the RuntimeError transformation.
-
exception
StopAsyncIteration¶ -
Must be raised by
__anext__()method of an
asynchronous iterator object to stop the iteration.New in version 3.5.
-
exception
SyntaxError¶ -
Raised when the parser encounters a syntax error. This may occur in an
importstatement, in a call to the built-in functionsexec()
oreval(), or when reading the initial script or standard input
(also interactively).Instances of this class have attributes
filename,lineno,
offsetandtextfor easier access to the details.str()
of the exception instance returns only the message.
-
exception
IndentationError¶ -
Base class for syntax errors related to incorrect indentation. This is a
subclass ofSyntaxError.
-
exception
TabError¶ -
Raised when indentation contains an inconsistent use of tabs and spaces.
This is a subclass ofIndentationError.
-
exception
SystemError¶ -
Raised when the interpreter finds an internal error, but the situation does not
look so serious to cause it to abandon all hope. The associated value is a
string indicating what went wrong (in low-level terms).You should report this to the author or maintainer of your Python interpreter.
Be sure to report the version of the Python interpreter (sys.version; it is
also printed at the start of an interactive Python session), the exact error
message (the exception’s associated value) and if possible the source of the
program that triggered the error.
-
exception
SystemExit¶ -
This exception is raised by the
sys.exit()function. It inherits from
BaseExceptioninstead ofExceptionso that it is not accidentally
caught by code that catchesException. This allows the exception to
properly propagate up and cause the interpreter to exit. When it is not
handled, the Python interpreter exits; no stack traceback is printed. The
constructor accepts the same optional argument passed tosys.exit().
If the value is an integer, it specifies the system exit status (passed to
C’sexit()function); if it isNone, the exit status is zero; if
it has another type (such as a string), the object’s value is printed and
the exit status is one.A call to
sys.exit()is translated into an exception so that clean-up
handlers (finallyclauses oftrystatements) can be
executed, and so that a debugger can execute a script without running the risk
of losing control. Theos._exit()function can be used if it is
absolutely positively necessary to exit immediately (for example, in the child
process after a call toos.fork()).-
code¶ -
The exit status or error message that is passed to the constructor.
(Defaults toNone.)
-
-
exception
TypeError¶ -
Raised when an operation or function is applied to an object of inappropriate
type. The associated value is a string giving details about the type mismatch.This exception may be raised by user code to indicate that an attempted
operation on an object is not supported, and is not meant to be. If an object
is meant to support a given operation but has not yet provided an
implementation,NotImplementedErroris the proper exception to raise.Passing arguments of the wrong type (e.g. passing a
listwhen an
intis expected) should result in aTypeError, but passing
arguments with the wrong value (e.g. a number outside expected boundaries)
should result in aValueError.
-
exception
UnboundLocalError¶ -
Raised when a reference is made to a local variable in a function or method, but
no value has been bound to that variable. This is a subclass of
NameError.
-
exception
UnicodeError¶ -
Raised when a Unicode-related encoding or decoding error occurs. It is a
subclass ofValueError.UnicodeErrorhas attributes that describe the encoding or decoding
error. For example,err.object[err.start:err.end]gives the particular
invalid input that the codec failed on.-
encoding¶ -
The name of the encoding that raised the error.
-
reason¶ -
A string describing the specific codec error.
-
object¶ -
The object the codec was attempting to encode or decode.
-
start¶ -
The first index of invalid data in
object.
-
end¶ -
The index after the last invalid data in
object.
-
-
exception
UnicodeEncodeError¶ -
Raised when a Unicode-related error occurs during encoding. It is a subclass of
UnicodeError.
-
exception
UnicodeDecodeError¶ -
Raised when a Unicode-related error occurs during decoding. It is a subclass of
UnicodeError.
-
exception
UnicodeTranslateError¶ -
Raised when a Unicode-related error occurs during translating. It is a subclass
ofUnicodeError.
-
exception
ValueError¶ -
Raised when a built-in operation or function receives an argument that has the
right type but an inappropriate value, and the situation is not described by a
more precise exception such asIndexError.
-
exception
ZeroDivisionError¶ -
Raised when the second argument of a division or modulo operation is zero. The
associated value is a string indicating the type of the operands and the
operation.
The following exceptions are kept for compatibility with previous versions;
starting from Python 3.3, they are aliases of OSError.
-
exception
EnvironmentError¶
-
exception
IOError¶
-
exception
WindowsError¶ -
Only available on Windows.
5.2.1. OS exceptions¶
The following exceptions are subclasses of OSError, they get raised
depending on the system error code.
-
exception
BlockingIOError¶ -
Raised when an operation would block on an object (e.g. socket) set
for non-blocking operation.
Corresponds toerrnoEAGAIN,EALREADY,
EWOULDBLOCKandEINPROGRESS.In addition to those of
OSError,BlockingIOErrorcan have
one more attribute:-
characters_written¶ -
An integer containing the number of characters written to the stream
before it blocked. This attribute is available when using the
buffered I/O classes from theiomodule.
-
-
exception
ChildProcessError¶ -
Raised when an operation on a child process failed.
Corresponds toerrnoECHILD.
-
exception
ConnectionError¶ -
A base class for connection-related issues.
Subclasses are
BrokenPipeError,ConnectionAbortedError,
ConnectionRefusedErrorandConnectionResetError.
-
exception
BrokenPipeError¶ -
A subclass of
ConnectionError, raised when trying to write on a
pipe while the other end has been closed, or trying to write on a socket
which has been shutdown for writing.
Corresponds toerrnoEPIPEandESHUTDOWN.
-
exception
ConnectionAbortedError¶ -
A subclass of
ConnectionError, raised when a connection attempt
is aborted by the peer.
Corresponds toerrnoECONNABORTED.
-
exception
ConnectionRefusedError¶ -
A subclass of
ConnectionError, raised when a connection attempt
is refused by the peer.
Corresponds toerrnoECONNREFUSED.
-
exception
ConnectionResetError¶ -
A subclass of
ConnectionError, raised when a connection is
reset by the peer.
Corresponds toerrnoECONNRESET.
-
exception
FileExistsError¶ -
Raised when trying to create a file or directory which already exists.
Corresponds toerrnoEEXIST.
-
exception
FileNotFoundError¶ -
Raised when a file or directory is requested but doesn’t exist.
Corresponds toerrnoENOENT.
-
exception
InterruptedError¶ -
Raised when a system call is interrupted by an incoming signal.
Corresponds toerrnoEINTR.Changed in version 3.5: Python now retries system calls when a syscall is interrupted by a
signal, except if the signal handler raises an exception (see PEP 475
for the rationale), instead of raisingInterruptedError.
-
exception
IsADirectoryError¶ -
Raised when a file operation (such as
os.remove()) is requested
on a directory.
Corresponds toerrnoEISDIR.
-
exception
NotADirectoryError¶ -
Raised when a directory operation (such as
os.listdir()) is requested
on something which is not a directory.
Corresponds toerrnoENOTDIR.
-
exception
PermissionError¶ -
Raised when trying to run an operation without the adequate access
rights — for example filesystem permissions.
Corresponds toerrnoEACCESandEPERM.
-
exception
ProcessLookupError¶ -
Raised when a given process doesn’t exist.
Corresponds toerrnoESRCH.
-
exception
TimeoutError¶ -
Raised when a system function timed out at the system level.
Corresponds toerrnoETIMEDOUT.
New in version 3.3: All the above OSError subclasses were added.
See also
PEP 3151 — Reworking the OS and IO exception hierarchy
5.3. Warnings¶
The following exceptions are used as warning categories; see the warnings
module for more information.
-
exception
Warning¶ -
Base class for warning categories.
-
exception
UserWarning¶ -
Base class for warnings generated by user code.
-
exception
DeprecationWarning¶ -
Base class for warnings about deprecated features.
-
exception
PendingDeprecationWarning¶ -
Base class for warnings about features which will be deprecated in the future.
-
exception
SyntaxWarning¶ -
Base class for warnings about dubious syntax.
-
exception
RuntimeWarning¶ -
Base class for warnings about dubious runtime behavior.
-
exception
FutureWarning¶ -
Base class for warnings about constructs that will change semantically in the
future.
-
exception
ImportWarning¶ -
Base class for warnings about probable mistakes in module imports.
-
exception
UnicodeWarning¶ -
Base class for warnings related to Unicode.
-
exception
BytesWarning¶ -
Base class for warnings related to
bytesandbytearray.
-
exception
ResourceWarning¶ -
Base class for warnings related to resource usage.
New in version 3.2.
5.4. Exception hierarchy¶
The class hierarchy for built-in exceptions is:
BaseException +-- SystemExit +-- KeyboardInterrupt +-- GeneratorExit +-- Exception +-- StopIteration +-- StopAsyncIteration +-- ArithmeticError | +-- FloatingPointError | +-- OverflowError | +-- ZeroDivisionError +-- AssertionError +-- AttributeError +-- BufferError +-- EOFError +-- ImportError +-- ModuleNotFoundError +-- LookupError | +-- IndexError | +-- KeyError +-- MemoryError +-- NameError | +-- UnboundLocalError +-- OSError | +-- BlockingIOError | +-- ChildProcessError | +-- ConnectionError | | +-- BrokenPipeError | | +-- ConnectionAbortedError | | +-- ConnectionRefusedError | | +-- ConnectionResetError | +-- FileExistsError | +-- FileNotFoundError | +-- InterruptedError | +-- IsADirectoryError | +-- NotADirectoryError | +-- PermissionError | +-- ProcessLookupError | +-- TimeoutError +-- ReferenceError +-- RuntimeError | +-- NotImplementedError | +-- RecursionError +-- SyntaxError | +-- IndentationError | +-- TabError +-- SystemError +-- TypeError +-- ValueError | +-- UnicodeError | +-- UnicodeDecodeError | +-- UnicodeEncodeError | +-- UnicodeTranslateError +-- Warning +-- DeprecationWarning +-- PendingDeprecationWarning +-- RuntimeWarning +-- SyntaxWarning +-- UserWarning +-- FutureWarning +-- ImportWarning +-- UnicodeWarning +-- BytesWarning +-- ResourceWarning




