Concrete exceptions¶
The following exceptions are the exceptions that are usually raised.
exceptionAssertionError
¶
Raised when an assert
statement fails.
exceptionAttributeError
¶
Raised when an attribute reference (see Attribute references) orassignment fails. (When an object does not support attribute references orattribute assignments at all, TypeError
is raised.,)
exceptionEOFError
¶ exceptionFloatingPointError
¶
Not currently used.
exceptionGeneratorExit
¶
Raised when a generator or coroutine is closed;see generator.close()
and coroutine.close()
. Itdirectly inherits from BaseException
instead of Exception
sinceit is technically not an error.
exceptionImportError
¶
Raised when the import
statement has troubles trying toload a module., Også hevet når «fra listen» i from ... import
har et navn som ikke finnes.
name
og path
attributter kan bli sett ved hjelp av søkeord-onlyarguments til konstruktøren. Da satt de representerer navnet på modulethat ble forsøkt importert og banen til en fil som triggeredthe unntak, henholdsvis.
Endret i versjon 3.3: Lagt name
og path
egenskaper.,
unntakModuleNotFoundError
¶
En underklassen av ImportError
som er reist av import
når en modul kan ikke være plassert. Det er også hevet når None
er funnet i sys.modules
.
Ny i versjon 3.6.
unntakIndexError
¶
Hevet når en sekvens senket skrift er ute av rekkevidde. (Slice indekser aresilently avkortet å falle i tillatt område; hvis en indeks er ikke aninteger, TypeError
er hevet.,)
unntakKeyError
¶
Hevet når en tilordning (ordliste) – tasten er ikke funnet i settet av eksisterende nøkler.
unntakKeyboardInterrupt
¶
Hevet når brukeren treffer på interrupt-tasten (vanligvis Kontroll-C orDelete). Under utførelsen, en sjekk for avbrudd er maderegularly. Unntak arver fra BaseException
slik som å ikke beaccidentally fanget av koden som fanger Exception
og dermed preventthe tolk fra spennende.,
unntakMemoryError
¶
Hevet når en operasjon går ut av minnet, men situasjonen kan likevel berescued (ved å slette noen objekter). Tilhørende verdi er en streng indicatingwhat type (intern) drift kjørte ut av minnet. Merk at på grunn av theunderlying memory management arkitektur (C malloc()
funksjon), theinterpreter kan ikke alltid være i stand til å gjenopprette fra denne situasjonen, itnevertheless viser et unntak slik at en stabel traceback kan skrives ut, i tilfelle en run-away programmet var årsaken.,
unntakNameError
¶
Hevet når en lokal eller global navn er ikke funnet. Dette gjelder bare tounqualified navn. Tilhørende verdi er en feilmelding som inneholder thename som ikke kunne bli funnet.
unntakNotImplementedError
¶
Dette unntaket er hentet fra RuntimeError
. I brukerdefinert baseclasses, abstrakte metoder bør øke dette unntaket når de requirederived klasser til å overstyre metode, eller mens klassen er beingdeveloped for å indikere at den reelle gjennomføringen fortsatt behov for å bli lagt til.,
Merk
Det bør ikke brukes for å indikere at en operatør eller metode er notmeant til å bli støttet i det hele tatt – i så fall enten la operatør /metode udefinert eller, hvis en subclass, sett den til None
.
Merk
NotImplementedError
og NotImplemented
er ikke utskiftbare,selv om de har samme navn og formål. SeNotImplemented
for detaljer om når man skal bruke det.,
unntakOSError
()¶ unntakOSError
(errno, strerror]])
Dette unntaket er hevet når et system funksjonen returnerer en system-relatederror, inkludert i/U-feil som for eksempel «file not found» eller «disk full»(ikke for ulovlige argument typer eller andre tilfeldige feil).
Den andre formen av konstruktøren setter tilsvarende egenskaper,og som er beskrevet nedenfor. Attributtene som standard None
hvis notspecified., For bakoverkompatibilitet, hvis tre argumenter er bestått, args
attributtet inneholder bare en 2-tupleof de to første constructor argumenter.
konstruktør ofte faktisk returnerer en underklassen av OSError
, asdescribed i OS unntak nedenfor. Det bestemt subclass avhenger onthe siste errno
verdi. Dette problemet oppstår bare whenconstructing OSError
direkte eller via et alias, og er notinherited når subclassing.,
errno
¶
En numerisk feil kode fra C variabel errno
.
winerror
¶
Under Windows, dette gir deg nativeWindows feil kode. errno
attributtet er da en approximatetranslation, i POSIX-vilkår av at innfødte feil kode.
Under Windows, hvis winerror constructor argumentet er et heltall, errno
attributtet er bestemt ut fra Windows feil kode,og errno argumentet er ignorert., På andre plattformer, thewinerror argumentet er ignorert, og winerror
attributedoes ikke eksisterer.
strerror
¶
Den tilsvarende feilmelding, som fastsatt bythe operativsystem. Det er som er formatert av Cfunctions perror()
under POSIX, og FormatMessage()
under Windows.
filename
¶filename2
¶
For unntak som innebærer en fil system banen (for eksempel open()
elleros.unlink()
), filename
er navnet til filen som sendes til funksjonen.,For funksjoner som involverer to file system baner (for eksempelos.rename()
), filename2
tilsvarer secondfile navn sendt til funksjonen.
Endret i versjon 3.3: EnvironmentError
, IOError
, WindowsError
,socket.error
, select.error
ogmmap.error
har blitt slått sammen til OSError
, og theconstructor kan returnere en underklassen.
Endret i versjon 3.,4: filename
attributtet er nå den opprinnelige fil gått til funksjon, i stedet for navnet kodet eller dekodet fra thefilesystem koding. Også filnavn2 constructor argument andattribute ble lagt til.
unntakOverflowError
¶
Hevet når resultatet av en regnemåte er for stor til å berepresented. Dette kan ikke skje for heltall (som heller ville heveMemoryError
enn å gi opp). Imidlertid, av historiske årsaker,OverflowError er noen ganger reist for heltall som er utenfor en requiredrange., På grunn av mangel på standardisering av floating point exceptionhandling i C, mest floating point operations er ikke kontrollert.
unntakRecursionError
¶
Dette unntaket er hentet fra RuntimeError
. Det er hevet når theinterpreter oppdager at den maksimale recursion dybde (sesys.getrecursionlimit()
) er overskredet.
Ny i versjon 3.5: Tidligere en vanlig RuntimeError
ble hevet.,
unntakReferenceError
¶
Dette unntaket er hevet når en svak referanse proxy, som ble opprettet avweakref.proxy()
funksjon, brukes til å få tilgang til en attributt av referentafter det har vært søppel samles inn. For mer informasjon om svake referanser,se weakref
modulen.
unntakRuntimeError
¶
Hevet når det oppdages en feil som ikke faller inn i noen av de othercategories. Tilhørende verdi er en streng som angir hva nettopp wentwrong.,
unntakStopIteration
¶
Reist av innebygd funksjon next()
og en iterator er__next__()
metode for å signalisere at det er ingen furtheritems produsert av iterator.
unntak objekt har en enkelt attributt value
, som isgiven som et argument når konstruere unntak, og defaultsto None
.,
Når en generator eller coroutine functionreturns, en ny StopIteration
eksempel israised, og verdien som returneres av funksjonen brukes somvalue
– parameteren til konstruktøren av unntaket.
Hvis en generator koden direkte eller indirekte reiser StopIteration
,det er konvertert inn i en RuntimeError
(beholderStopIteration
som ny unntak er årsaken).
Endret i versjon 3.3: Lagt value
attributt og muligheten for generator funksjoner touse det å returnere en verdi.,
Endret i versjon 3.5: Introduserte RuntimeError transformasjon viafrom __future__ import generator_stop
, se PEP 479.
Endret i versjon 3.7: Aktiver PEP 479 for all kode som standard: en StopIteration
feil oppvokst i en generator er transformert inn i en RuntimeError
.
unntakStopAsyncIteration
¶
Må være reist av __anext__()
metode for anasynchronous iterator objekt for å stoppe iterasjon.
Ny i versjon 3.5.,
unntakSyntaxError
¶
Hevet når parseren møter en syntaksfeil. Dette kan skje i enimport
uttalelsen, i en samtale med den innebygde funksjoner exec()
eller eval()
, eller når du leser den første script eller standard inndata(også interaktivt).
Forekomster av denne klassen har attributter filename
, lineno
,offset
og text
for enklere tilgang til informasjon., str()
av unntaket eksempel returnerer bare melding.
unntakIndentationError
¶
Base klasse for syntaks feil relatert til feil innrykk. Dette er asubclass av SyntaxError
.
unntakTabError
¶
Hevet når innrykk inneholder en inkonsekvent bruk av faner og mellomrom.Dette er en underklassen av IndentationError
.
unntakSystemError
¶
Hevet når tolken finner en intern feil, men situasjonen gjør notlook så alvorlig for å få det til å gi opp alt håp., Tilhørende verdi er astring som indikerer hva som gikk galt (i lav-nivå vilkår).
Du bør rapportere dette til forfatteren eller utvikleren av Python-tolkeren.Sørg for å rapportere den versjonen av Python interpreter (sys.version
; det isalso skrives ut ved starten av en interaktiv Python økt), den eksakte errormessage (unntak er forbundet verdi) og hvis mulig kilde til theprogram som utløste feil.
unntakSystemExit
¶
Dette unntaket er reist av sys.exit()
funksjon., Det arver fraBaseException
i stedet for Exception
slik at det er ikke accidentallycaught av koden som fanger Exception
. Dette gjør unntak toproperly forplanter seg opp og føre til at tolk for å avslutte. Når det er nothandled, Python-tolkeren går ut, ingen stabelen traceback er skrevet ut. Theconstructor aksepterer den samme valgfritt argument gått til sys.exit()
.,Hvis verdien er et heltall, det angir system exit status (vedtatt innholdsfortegnelsen er exit()
funksjon); hvis det er None
, exit status er lik null. ifit har en annen type (for eksempel en string), objektets verdi er trykt andthe exit status er ett.
En-anrop til sys.exit()
er oversatt til et unntak slik at ren-uphandlers (finally
klausuler av try
uttalelser) kan beexecuted, og slik at en debugger kan kjøre et skript uten å kjøre riskof å miste kontrollen., os._exit()
funksjonen kan brukes hvis det isabsolutely positivt nødvendig for å avslutte umiddelbart (for eksempel i childprocess etter en samtale til os.fork()
).
code
¶
exit status eller feilmeldingen som er gått til konstruktøren.(Standard None
.)
unntakTypeError
¶
Hevet når en handling eller funksjon er lagt til et objekt av inappropriatetype. Tilhørende verdi er en streng og gir detaljer om type mismatch.,
Dette unntaket kan være reist av brukeren koden for å indikere at en attemptedoperation på et objekt er ikke støttes, og er ikke ment å være. Hvis en objectis ment å støtte en gitt operasjon, men har ennå ikke gitt animplementation, NotImplementedError
er riktig unntak for å høyne.
Passerer argumenter av feil type (f.eks. passerer en list
når enint
er forventet) skal resultere i en TypeError
, men passingarguments med feil verdi (f.eks., en rekke utenfor forventet grenser)skal resultere i en ValueError
.
unntakUnboundLocalError
¶
Hevet når en referanse er gjort til en lokal variabel i en funksjon eller metode, butno verdi har vært bundet til den variabelen. Dette er en underklassen avNameError
.
unntakUnicodeError
¶
Hevet når en Unicode-i slekt å kode eller avkode det oppstår feil. Det er asubclass av ValueError
.
UnicodeError
har attributter som beskriver koding eller decodingerror., For eksempel, err.object
gir particularinvalid innspill som kodeken mislyktes på.
encoding
¶
navnet på koding som hevet feil.
reason
¶
En streng som beskriver bestemt kodek feil.
object
¶
objektet kodeken var å forsøke å kode eller avkode.
start
¶
Den første indeksen er ugyldig data i object
.
end
¶
indeksen etter siste ugyldige data i object
.,
exceptionUnicodeEncodeError
¶
Raised when a Unicode-related error occurs during encoding. It is a subclass ofUnicodeError
.
exceptionUnicodeDecodeError
¶
Raised when a Unicode-related error occurs during decoding. It is a subclass ofUnicodeError
.
exceptionUnicodeTranslateError
¶
Raised when a Unicode-related error occurs during translating. It is a subclassof UnicodeError
.,
unntakValueError
¶
Hevet når en handling eller funksjon, mottar et argument som har theright type, men en upassende verdi, og situasjonen er ikke beskrevet ved amore presis unntak som for eksempel IndexError
.
unntakZeroDivisionError
¶
Hevet når det andre argumentet for en avdeling eller modulus drift er null. Theassociated verdi er en streng som angir typen av operander og theoperation.
følgende unntak er holdt for kompatibilitet med tidligere versjoner;med start fra Python-3.,3, de er aliaser av OSError
.
unntakEnvironmentError
¶ unntakIOError
¶ unntakWindowsError
¶
Bare tilgjengelig på Windows.
OS unntak¶
følgende unntak underklasser av OSError
, de får raiseddepending på systemet feilkode.
unntak BlockingIOError
¶
Hevet når en operasjon ville blokkere på et objekt (f.eks. socket) setfor ikke-blokkerende drift.,Tilsvarer errno
EAGAIN
, EALREADY
,EWOULDBLOCK
og EINPROGRESS
.
I tillegg til de av OSError
, BlockingIOError
kan haveone mer attributt:
characters_written
¶
En integer som inneholder antall tegn skrevet til streambefore det blokkert. Denne egenskapen er tilgjengelig når du bruker thebuffered I/O klasser fra io
modulen.,
exception ChildProcessError
¶
Raised when an operation on a child process failed.Corresponds to errno
ECHILD
.
exception ConnectionError
¶
A base class for connection-related issues.
Subclasses are BrokenPipeError
, ConnectionAbortedError
,ConnectionRefusedError
and ConnectionResetError
.,
unntak BrokenPipeError
¶
En underklassen av ConnectionError
, hevet når du prøver å skrive på apipe mens den andre enden har vært stengt, eller prøver å skrive på en socketwhich har blitt avslutning for å skrive.Tilsvarer errno
EPIPE
og ESHUTDOWN
.
unntak ConnectionAbortedError
¶
En underklassen av ConnectionError
, hevet når en tilkobling attemptis avbrutt av peer.Tilsvarer errno
ECONNABORTED
.,
unntak ConnectionRefusedError
¶
En underklassen av ConnectionError
, hevet når en tilkobling attemptis nektet av peer.Tilsvarer errno
ECONNREFUSED
.
unntak ConnectionResetError
¶
En underklassen av ConnectionError
, hevet når en tilkobling isreset av peer.Tilsvarer errno
ECONNRESET
.
unntak FileExistsError
¶
Hevet når du prøver å opprette en katalog eller fil som allerede eksisterer.,Corresponds to errno
EEXIST
.
exception FileNotFoundError
¶
Raised when a file or directory is requested but doesn’t exist.Corresponds to errno
ENOENT
.
exception InterruptedError
¶
Raised when a system call is interrupted by an incoming signal.Corresponds to errno
EINTR
.
Changed in version 3.,5: Python nå gjentar system anrop når du er i en syscall er avbrutt av asignal, unntatt hvis signalet handler viser et unntak (se PEP 475for begrunnelsen), i stedet for å heve InterruptedError
.
unntak IsADirectoryError
¶
Hevet når en fil operasjon (for eksempel os.remove()
) requestedon en katalog.Tilsvarer errno
EISDIR
.
unntak NotADirectoryError
¶
Hevet når en katalog drift (for eksempel os.listdir()
) requestedon noe som ikke er en katalog.,Corresponds to errno
ENOTDIR
.
exception PermissionError
¶
Raised when trying to run an operation without the adequate accessrights – for example filesystem permissions.Corresponds to errno
EACCES
and EPERM
.
exception ProcessLookupError
¶
Raised when a given process doesn’t exist.Corresponds to errno
ESRCH
.
exception TimeoutError
¶
Raised when a system function timed out at the system level.,Tilsvarer errno
ETIMEDOUT
.
Ny i versjon 3.3: Alle de ovennevnte OSError
underklasser ble lagt til.
Se også
PEP 3151 – Omarbeiding OS og IO unntak hierarki