[Python] os.pathの使い方

2023年4月14日2023年11月24日

Pythonのos.pathモジュールは、ファイルやディレクトリのパスを扱うためのユーティリティ関数を提供するモジュールです。このモジュールを使用することで、パスを操作する上で必要な機能が提供されます。以下では、os.pathモジュールの使い方を詳しく説明します。

モジュールのインポート

まずはじめに、os.pathモジュールをインポートする必要があります。以下のように、import文を使用してos.pathモジュールをインポートします。

import os.path

os.pathモジュールには、パスの構成要素を取得するための関数が用意されています。主なものを以下に示します。

os.path.basename()関数は、パスの末尾にあるファイル名またはディレクトリ名を返します。

import os.path

path = '/path/to/file.txt'
print(os.path.basename(path))  # file.txt

os.path.dirname()関数は、パスの末尾を除いたディレクトリのパスを返します。

import os.path

path = '/path/to/file.txt'
print(os.path.dirname(path))  # /path/to

os.path.split()関数は、パスをディレクトリとファイル名に分割して返します。

import os.path

path = '/path/to/file.txt'
print(os.path.split(path))  # ('/path/to', 'file.txt')

os.path.splitext()関数は、ファイルの拡張子を含むパスを、拡張子を除いた部分と拡張子の部分に分割して返します。

import os.path

path = '/path/to/file.txt'
print(os.path.splitext(path))  # ('/path/to/file', '.txt')

os.pathモジュールには、複数のパスを結合するための関数も用意されています。主なものを以下に示します。

os.path.join()関数は、複数のパス要素を連結して、新しいパスを作成します。

import os.path

path1 = '/path/to'
path2 = 'file.txt'
print(os.path.join(path1, path2))  # /path/to/file.txt

os.path.abspath()関数は、相対パスを絶対パスに変換します。

import os.path

path = 'file.txt'
print(os.path.abspath(path))  # /current/directory/file

os.pathモジュールには、パスが存在するかどうかを確認するための関数が用意されています。主なものを以下に示します。

os.path.exists()関数は、指定されたパスが存在するかどうかを判定します。

import os.path

path = '/path/to/file.txt'
if os.path.exists(path):
    print('The file exists.')
else:
    print('The file does not exist.')

os.path.isfile()関数は、指定されたパスがファイルかどうかを判定します。

import os.path

path = '/path/to/file.txt'
if os.path.isfile(path):
    print('The path is a file.')
else:
    print('The path is not a file.')

os.path.isdir()関数は、指定されたパスがディレクトリかどうかを判定します。

import os.path

path = '/path/to'
if os.path.isdir(path):
    print('The path is a directory.')
else:
    print('The path is not a directory.')

os.pathモジュールには、パスを操作するための関数も用意されています。主なものを以下に示します。

os.path.abspath()関数は、相対パスを絶対パスに変換します。

import os.path

path = 'file.txt'
print(os.path.abspath(path))  # /current/directory/file.txt

os.path.relpath()関数は、2つのパスの相対パスを取得します。

import os.path

path1 = '/path/to/file.txt'
path2 = '/path'
print(os.path.relpath(path1, path2))  # ../to/file.txt

以上で、os.pathモジュールの基本的な使い方について説明しました。パスの構成要素の取得や、パスの結合、パスの存在を確認する方法、さらにパスの操作についても説明しました。これらの関数を駆使して、効率的なパスの操作を行ってください。

よかったらシェアしてね！