6.2 `os.path` -- 共通のパス名操作

このモジュールには、パス名を操作する便利な関数が定義されています。

警告: これらの関数の多くはWindowsの一律命名規則（UNCパス名）を正しくサポートしていません。splitunc()とismount()は正しくUNCパス名を操作できます。

abspath( path): pathの標準化された絶対パスを返します。たいていのプラットフォームでは、 normpath(join(os.getcwd(), path))と同じ結果になります。バージョン1.5.2 以降で新規追加された仕様です。

basename( path): パス名pathの末尾のファイル名を返します。これはsplit(path)で返されるペアの２番目の要素です。この関数が返す値はUnixの basenameとは異なります； Unixのbasenameは'/foo/bar/'に対して 'bar'を返しますが、basename()は空文字列('') を返します。

commonprefix( list): パスのlistの中の共通する最長のプレフィックスを（パス名の１文字１文字を判断して）返します。もしlistが空なら、空文字列('')を返します。これは一度に１文字を扱うため、不正なパスを返すことがあるかもしれませんので注意して下さい。

dirname( path): パスpathのディレクトリ名を返します。これはsplit(path)で返されるペアの最初の要素です。

exists( path): pathが存在するなら、Trueを返します。

expanduser( path): 与えられた引数の最初の"~"または"~user"を、userのホームディレクトリのパスに置き換えて返します。最初が"~"なら、環境変数のHOMEの値に置き換えられます； "~user"なら、ビルトインモジュール pwdを使ってパスワードディレクトリから該当するものを検索します。もし置き換えに失敗したり、引数のパスがチルダで始まっていなかったら、パスをそのまま返します。 Macintoshではpathをそのまま返します。

expandvars( path): 引数のパスを環境変数に展開して返します。引数の中の"$name"または"${name}"の文字列が環境変数のnameに置き換えられます。不正な変数名や存在しない変数名の場合には変換されず、そのまま返します。 Macintoshではpathをそのまま返します。

getatime( path): pathに最後にアクセスした時刻を、エポック（timeモジュールを参照）からの経過時間を示す秒数で返します。ファイルが存在しなかったりアクセスできない場合はos.errorを発生します。バージョン2.3 以降で変更された仕様: os.stat_float_times()がTrueを返す場合、戻り値は浮動小数点値となります。バージョン1.5.2 以降で新規追加された仕様です。

getmtime( path): pathの最終更新時刻を、エポック（timeモジュールを参照）からの経過時間を示す秒数で返します。ファイルが存在しなかったりアクセスできない場合はos.errorを発生します。バージョン2.3 以降で変更された仕様: os.stat_float_times()がTrueを返す場合、戻り値は浮動小数点値となります。バージョン1.5.2 以降で新規追加された仕様です。

getctime( path): システムによって、ファイルの最終変更時刻 (Unix のようなシステム) や作成時刻 (Windows のようなシステム) をシステムの ctime で返します。戻り値はエポック（timeモジュールを参照）からの経過秒数を示す数値です。ファイルが存在しなかったりアクセスできない場合はos.errorを発生します。バージョン2.3 以降で新規追加された仕様です。

getsize( path): ファイルpathのサイズをバイト数で返します。ファイルが存在しなかったりアクセスできない場合はos.errorを発生します。バージョン1.5.2 以降で新規追加された仕様です。

isabs( path): pathが絶対パス（スラッシュで始まる）なら、Trueを返します。

isfile( path): pathが存在する正しいファイルなら、Trueを返します。シンボリックリンクの場合にはその実体をチェックするので、同じパスに対して islink()とisfile()の両方がTrueを返すことがあります。

isdir( path): pathが存在するなら、Trueを返します。シンボリックリンクの場合にはその実体をチェックするので、同じパスに対して islink()とisfile()の両方がTrueを返すことがあります。

islink( path): pathがシンボリックリンクなら、Trueを返します。シンボリックリンクがサポートされていないプラットフォームでは、常に Falseを返します。

ismount( path): パス名pathがマウントポイントmount point（ファイルシステムの中で異なるファイルシステムがマウントされているところ）なら、True を返します：この関数はpathの親ディレクトリであるpath/..が pathと異なるデバイス上にあるか、あるいはpath/..と pathが同じデバイス上の同じi-nodeを指しているかをチェックします-- これによって全てのUnixとPOSIX標準でマウントポイントが検出できます。

join( path1[, path2[, ...]]): パスに１つあるいはそれ以上のパスの要素をうまく結合します。付け加える要素に絶対パスがあれば、それより前の要素は全て破棄され、以降の要素を結合します。戻り値はpath1と省略可能なpath2以降を結合したもので、 path2が空文字列でないなら、ディレクトリの区切り文字(os.sep) が各要素の間に挿入されます。 Windowsでは各ドライブに対してカレントディレクトリがあるので、 os.path.join("c:", "foo")によって、 c:\\fooではなく、ドライブC:上のカレントディレクトリからの相対パス（c:foo）が返されます。

normcase( path): パス名の大文字、小文字をシステムの標準にします。 Unixではそのまま返します。大文字、小文字を区別しないファイルシステムではパス名を小文字に変換します。 Windowsでは、スラッシュをバックスラッシュに変換します。

normpath( path): パス名を標準化します。余分な区切り文字や上位レベル参照を削除します。例えば、A//B、 A/./B、A/foo/../Bは全てA/Bになります。大文字、小文字は標準化しません（それにはnormcase()を使って下さい）。 Windowsでは、スラッシュをバックスラッシュに変換します。

realpath( path): パスの中のシンボリックリンクを取り除いて、標準化したパスを返します。利用可能：Unix。バージョン2.2 以降で新規追加された仕様です。

samefile( path1, path2): ２つの引数であるパス名が同じファイルあるいはディレクトリを指していれば（同じデバイスナンバーとi-nodeナンバーで示されていれば）、Trueを返します。どちらかのパス名でos.stat()の呼び出しに失敗した場合には、例外が発生します。利用可能：Macintosh、Unix

sameopenfile( fp1, fp2): fp1とfp2が同じファイルオブジェクトを指していたら、 Trueを返します。２つのファイルオブジェクトが異なるファイルディスクリプタを示すこともあります。利用可能：Macintosh、Unix

samestat( stat1, stat2): statタプルstat1とstat2が同じファイルを指していたら、 Trueを返します。これらのタプルはfstat()、lstat()や stat()で返されたものでかまいません。この関数は、samefile()とsameopenfile()で使われるのと同様なものを背後に実装しています。利用可能：Macintosh、Unix

split( path): パス名pathを(headとtail)のペアに分割します。 tailはパスの構成要素の末尾で、headはそれより前の部分です。 tailはスラッシュを含みません；もしpathの最後にスラッシュがあれば、tailは空文字列になります。もしpathにスラッシュがなければ、headは空文字列になります。 pathが空文字列なら、headとtailのどちらも空文字列になります。 headの末尾のスラッシュは、headがルートディレクトリ（１つ以上のスラッシュのみ）でない限り、取り除かれます。ほとんど全ての場合、join(head, tail)の結果が pathと等しくなります（ただ１つの例外は、複数のスラッシュが headとtailを分けている時です）。

splitdrive( path): パス名pathを(drive,tail)のペアに分割します。 driveはドライブ名か、空文字列です。ドライブ名を使用しないシステムでは、driveは常に空文字列です。全ての場合にdrive + tailはpathと等しくなります。バージョン1.3 以降で新規追加された仕様です。

splitext( path): パス名pathを(root, ext)のペアにします。 root + ext == pathになります。 extは空文字列か１つのピリオドで始まり、多くても１つのピリオドを含みます。

walk( path, visit, arg)

pathをルートとする各ディレクトリに対して（もしpathがディレクトリならpathも含みます）、

(arg, dirname, 
names)

を引数として関数visitを呼び出します。引数dirnameは訪れたディレクトリを示し、引数namesはそのディレクトリ内のファイルのリスト（os.listdir(dirname)で得られる）です。関数visitによってnamesを変更して、dirname以下の対象となるディレクトリのセットを変更することもできます。例えば、あるディレクトリツリーだけ関数を適用しないなど。（namesで参照されるオブジェクトは、delあるいはスライスを使って正しく変更しなければなりません。）

注意: ディレクトリへのシンボリックリンクはサブディレクトリとして扱われないので、walk()による操作対象とはされません。ディレクトリへのシンボリックリンクを操作対象とするには、 os.path.islink(file)とos.path.isdir(file) で識別して、walk()で必要な操作を実行しなければなりません。

注意: 新たに追加されたos.walk() ジェネレータを使用すれば、同じ処理をより簡単に行う事ができます。

supports_unicode_filenames: 任意のユニコード文字列を（ファイルシステムの制限内で）ファイルネームに使うことが可能で、os.listdirがユニコード文字列の引数に対してユニコードを返すなら、真を返します。バージョン2.3 以降で新規追加された仕様です。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

6.2 os.path -- 共通のパス名操作

6.2 `os.path` -- 共通のパス名操作