os.pad – gemeenschappelijke padnaam manipulaties¶

broncode: Lib/posixpath.py (voor POSIX) andLib/ntpath.py (Voor Windows NT).

deze module implementeert enkele nuttige functies op padnamen. Voor het lezen van orwrite bestanden zie open(), en voor toegang tot het bestandssysteem zie deos module. De path parameters kunnen worden doorgegeven als strings, of bytes. Toepassingen worden aangemoedigd om bestandsnamen weer te geven als(Unicode) tekenreeksen. Helaas kunnen sommige bestandsnamen niet als tekenreeksen op Unix worden weergegeven, dus toepassingen die willekeurige bestandsnamen op Unix moeten ondersteunen, moeten bytes-objecten gebruiken om Path-namen weer te geven. Omgekeerd kan het gebruik van bytes-objecten niet alle bestandsnamen op Windows vertegenwoordigen( in de standaard mbcs – codering), vandaar dat Windowsapplicaties string-objecten moeten gebruiken om toegang te krijgen tot alle bestanden.

in tegenstelling tot een Unix shell, voert Python geen automatische paduitbreidingen uit.Functies zoals expanduser() en expandvars() kunnen expliciet worden ingeroepen wanneer een toepassing een shell-achtige paduitbreiding wenst. (Zie ook de glob module.)

os.path.abspath(path)¶

Geef een genormaliseerde versie van het padnaam pad terug. Op de meeste platforms is dit gelijk aan het aanroepen van de functie normpath() als volgt: normpath(join(os.getcwd(), path)).

os.path.basename(path)¶

Geef de basisnaam van pathname path terug. Dit is het tweede element van de pair dat wordt geretourneerd door het pad naar de functie split()door te geven. Merk op dat het resultaat van deze functie verschilt van het Unix basename programma; waar basename voor'/foo/bar/' 'bar' geeft, geeft de functie basename() een lege tekenreeks ('') terug.

os.path.commonpath(paden)¶

geeft het langste gemeenschappelijke subpad van elke padnaam in de sequencepaths terug. Verhoog ValueError als paden zowel absolute als relatieve padnamen bevatten, staan de paden op de verschillende stations of zijn paden leeg. In tegenstelling tot commonprefix() geeft dit avalid pad terug.

Beschikbaarheid: Unix, Windows.

os.path.commonprefix(list)¶

geef het langste pad-voorvoegsel terug (karakter-voor-karakter genomen) dat aprefix is van alle paden in de lijst. Als de lijst leeg is, geeft u de lege tekenreeks('') terug.

>>> os.path.commonprefix()'/usr/l'>>> os.path.commonpath()'/usr'

os.path.dirname(path)¶

Geef de mapnaam van pathname path terug. Dit is het eerste element van het paar dat wordt geretourneerd door pad door te geven naar de functie split().

os.path.exists(path)¶

Return True if path refereert naar een bestaand pad of een openfile descriptor. Geeft False terug voor verbroken symbolische koppelingen. Op sommige platforms kan deze functie False teruggeven als er geen toestemming is verleend om os.stat() uit te voeren op het gevraagde bestand, zelfs als het pad fysiek bestaat.

os.path.lexists(path)¶

Return True if path refereert naar een bestaand pad. Geeft True voor afgebroken symbolische koppelingen terug. Gelijk aan exists() op platforms zonderos.lstat().

os.path.expanduser(path)¶

op Unix en Windows, retourneer het argument met een initiële component van ~ of~user vervangen door de persoonlijke map van die gebruiker.

op Unix wordt een initiaal ~ vervangen door de omgevingsvariabele HOMEindien deze is ingesteld; anders wordt de persoonlijke map van de huidige gebruiker opgezocht in de wachtwoordmap via de ingebouwde module pwd. Een initiaal ~userwordt direct opgezocht in de wachtwoordmap.

op Windows wordt USERPROFILE gebruikt indien ingesteld, anders wordt een combinatie van HOMEPATH en HOMEDRIVE gebruikt. Een initiaal~user wordt afgehandeld door het laatste directory-component te verwijderen van het hierboven afgeleide createduser-pad.

als de uitbreiding mislukt of als het pad niet met een tilde begint, wordt het pad onveranderd omgekeerd.

os.path.expandvars(path)¶

geef het argument terug met uitgevouwen omgevingsvariabelen. Substrings in de vorm$name of ${name} worden vervangen door de waarde van environment variablename. Misvormde namen van variabelen en verwijzingen naar niet-bestaande variabelen zijn links ongewijzigd.

op Windows worden uitbreidingen %name% ondersteund naast $name en${name}.

os.path.getatime(path)¶

Geef de tijd van de laatste toegang van pad terug. De return waarde is een floating point getal dat het aantal seconden sinds de epoch geeft (zie de time module). VerhoogOSError als het bestand niet bestaat of ontoegankelijk is.

os.path.getmtime(path)¶

Geef de tijd van de laatste wijziging van pad terug. De return waarde is een floating point numberg die het aantal seconden sinds de epoch aangeeft (zie de time module).Verhoog OSError als het bestand niet bestaat of ontoegankelijk is.

os.path.getctime(path)¶

Geef de ctime van het systeem terug die op sommige systemen (zoals Unix) de tijd is van de laatste metadata verandering, en op andere (zoals Windows), de aanmaaktijd is voor path.De return waarde is een getal dat het aantal seconden geeft sinds de epoch (zie de time module). Verhoog OSError als het bestand niet bestaat of ontoegankelijk is.

os.path.getsize(path)¶

Geef de grootte, in bytes, van path terug. Verhoog OSError als het bestand niet bestaat of ontoegankelijk is.

os.path.isabs(path)¶

geef True terug als path een absolute padnaam is. Op Unix betekent dit dat het begint met een slash, op Windows begint het met een (back)slash na het afhakken van een potentiële stationsletter.

os.path.isfile(path)¶

Return True if path is an existing regular file.Dit volgt symbolische koppelingen, dus zowel islink() als isfile() kunnen waar zijn voor hetzelfde pad.

os.path.isdir(path)¶

Return True if path is an existing directory. Dit volgt symbolische koppelingen, dus zowel islink() als isdir() kunnen waar zijn voor hetzelfde pad.

os.path.islink(path)¶

Return True if path refereert naar een existing directoryentry die een symbolische link is. Altijd False als symbolische koppelingen niet ondersteund worden door de Python runtime.

os.path.ismount(path)¶

Return True if pathname path is a mount point: een punt in een bestandssysteem waar een ander bestandssysteem is aangekoppeld. Op POSIX controleert de functie of de ouder van pad, path/.., zich op een ander apparaat bevindt dan pad, of dat path/.. en pad naar de samei-node op hetzelfde apparaat wijzen — Dit zou koppelpunten moeten detecteren voor alle UNIX-en POSIX-varianten. Het is niet in staat om bind mounts betrouwbaar te detecteren op hetzelfde bestandssysteem. In Windows worden een stationsletter root en een share UNC altijd koppelpunten, en voor elk ander pad GetVolumePathName wordt aangeroepen om te zien of het verschilt van het invoerpad.

os.path.join(path, * paths)¶

op intelligente wijze een of meer padcomponenten verbinden. De return waarde is de samenvoeging van pad en alle leden van *paden met exact ééndirectory scheidingsteken (os.sep) na elk niet-leeg deel behalve het laatste, wat betekent dat het resultaat alleen eindigt in een scheidingsteken als het laatste deel leeg is. Als een component een absoluut pad is, worden alle voorgaande componenten weggegooid en gaat de verbinding verder vanaf het absolute padcomponent.

in Windows wordt de stationsletter niet gereset wanneer een absoluut padcomponent (bijvoorbeeld r'\foo') wordt aangetroffen. Als een component een driveletter bevat, worden alle voorgaande componenten weggegooid en wordt de stationsletter opnieuw ingesteld. Merk op dat, aangezien er een huidige map is voor elk station,os.path.join("c:", "foo") een pad vertegenwoordigt relatief aan de huidige map op station C: (c:foo), niet c:\foo.

os.path.normcase(path)¶

normaliseer het geval van een padnaam. In Windows, Converteer alle tekens in thepathname naar kleine letters, en converteer ook vooruit slashes naar achterwaartse slashes.Geef op andere besturingssystemen het pad ongewijzigd terug.

os.path.normpath(path)¶

normaliseer een padnaam door redundante scheidingstekens en verwijzingen naar een hoger niveau in te klappen zodat A//B, A/B/, A/./B en A/foo/../B allbecome A/B. Deze string manipulatie kan de Betekenis veranderen van een pad dat symbolische links bevat. Op Windows zet het naar voren schuine strepen om naar achteren schuine strepen. Gebruik normcase()om hoofdletters te normaliseren.

os.path.realpath(path)¶

geef het canonieke pad van de opgegeven bestandsnaam terug, waarbij alle symbolische links in het pad worden geëlimineerd (als ze door het besturingssysteem worden ondersteund).

os.path.relpath(pad, start = os.curdir)¶

Geef een relatief bestandspad terug naar het pad van de huidige map of van een optionele startmap. Dit is een padberekening: het bestandssysteem wordt niet benaderd om het bestaan of de aard van pad ofstart te bevestigen.

start standaard os.curdir.

Beschikbaarheid: Unix, Windows.

os.path.samefile(path1, path2)¶

geef True terug als beide pathname-argumenten naar hetzelfde bestand of dezelfde map verwijzen.Dit wordt bepaald door het apparaatnummer en het i-knooppuntnummer en roept een uitzondering op als een os.stat() aanroep op een van beide padnamen mislukt.

Beschikbaarheid: Unix, Windows.

os.path.sameopenfile(FP1, fp2)¶

geef True terug als de bestandsdescriptoren fp1 en fp2 naar hetzelfde bestand verwijzen.

Beschikbaarheid: Unix, Windows.

os.path.samestat(stat1, stat2)¶

geef True terug als de statussen stat1 en stat2 naar hetzelfde bestand verwijzen.Deze structuren kunnen zijn geretourneerd met os.fstat(),os.lstat() of os.stat(). Deze functie implementeert de onderliggende vergelijking die wordt gebruikt door samefile() en sameopenfile().

Beschikbaarheid: Unix, Windows.

os.path.split(path)¶

splits het padnaam pad in een paar, (head, tail) waar tail de laatste padnaam component is en head alles is wat daar naartoe leidt. Het staart deel zal nooit een slash bevatten; als pad eindigt in een slash, staart zal leeg zijn. Als er geen schuine streep in pad is, zal het hoofd leeg zijn. Alspath leeg is, zijn zowel kop als staart leeg. Trailing slashes arestripped van het hoofd, tenzij het de wortel (een of meer slashes alleen). In alle gevallen geeft join(head, tail) een pad terug naar dezelfde locatie als pad (maar de tekenreeksen kunnen verschillen). Zie ook de functies dirname() enbasename().

os.path.splitdrive(path)¶

splits het padnaam pad in een paar (drive, tail) waarbij het station een aankoppelpunt of de lege tekenreeks is. Op systemen die geen drivespecifications gebruiken, zal drive altijd de lege string zijn. In alle gevallen zal drive+ tail hetzelfde zijn als path.

op Windows splitst een padnaam in drive / UNC sharepoint en relatief pad.

als het pad een stationsletter bevat, bevat het station alles tot en met de dubbele punt.bijv. splitdrive("c:/dir") geeft ("c:", "/dir")

als het pad een UNC-pad bevat, zal het station de hostnaam en share bevatten, tot maar niet met inbegrip van het vierde scheidingsteken.bv. splitdrive("//host/computer/dir") geeft terug ("//host/computer", "/dir")

os.path.splitext(path)¶

splits het padnaam pad in een paar (root, ext) zodanig dat root + ext ==path, en ext leeg is of begint met een punt en maximaal één periode bevat. Aanloopperiodes op de basisnaam worden genegeerd; splitext('.cshrc')geeft ('.cshrc', '')terug.

os.path.supports_unicode_filenames