21.2. os.path - работа с именами путей 281

dirname( path)

Возвращает имя каталога в пути path. Это первый элемент пары split( path) . exists( path)

Возвращает 1 , если путь с именем path (файл или каталог) существует, иначе возвращает 0 .

expanduser(path)

Возвращает аргумент с компонентом вида ~ или ~user , замененным домашним каталогом пользователя. ~ заменяется значением переменной окружения HOME, поиск имени домашнего каталога для пользователя user производится с помощью модуля pwd. Если замена по каким-либо причинам не может быть произведена или путь не начинается с символа ~ , возвращает path без изменений.

expandvars( path)

Возвращает аргумент с компонентами вида $name и ${name} , замененными значением переменной окружения name. Некорректные имена и имена, ссылающиеся на неопределенные переменные, оставляются в строке path без изменений. При использовании ОС Macintosh всегда возвращает path без изменений.

getatime( path)

Возвращает время (число секунд с начала эпохи, см. описание модуля time) последнего доступа к файлу (каталогу) path. Генерирует исключение IOError, если файл не существует или не доступен.

getmtime( path)

Возвращает время (число секунд с начала эпохи, см. описание модуля time) последнего внесения изменений в файл (каталог) path. Генерирует исключение IOError , если файл не существует или не доступен.

getsize( path)

Возвращает размер в байтах файла (каталога) path. Генерирует исключение IOError , если файл не существует или не доступен.

isabs ( path)

Возвращает 1 , если путь path является абсолютным.

isfile( path)

Возвращает 1 , если путь path указывает на существующий обычный файл, иначе возвращает 0 . Эта функция следует символическим ссылкам, то есть функции islink() и isfile() могут обе возвращать истину для одного и того же пути.

isdir( path)

Возвращает 1 , если путь path указывает на существующий каталог, иначе возвращает 0. Эта функция следует символическим ссылкам, то есть функции islink() и isdir() могут обе возвращать истину для одного и того же пути.

islink( path)

Возвращает 1 , если путь path является символической ссылкой, иначе возвращает 0 . Всегда возвращает 0 , если символические ссылки не поддерживаются.

ismount( path)

Возвращает 1 , если путь path является точкой монтирования, то есть каталог path и родительский для него каталог находятся на разных устройствах (разделах) или ссылаются на один и тот же узел (i-node) одного устройства.

join (pathl [, path2 ...])

Объединяет компоненты пути. Если какой-либо компонент является абсолютным путем, все предыдущие компоненты отбрасываются и объединение продолжается. Возвращаемое значение является объединением всех непустых строк pathl, path2 и т. д., в качестве разделителя используется os.sep. Если последний аргумент является пустой строкой, результат заканчивается символом os.sep.

normcase( path)

Возвращает path с нормализованным регистром букв. На платформах UNIX возвращает аргумент без изменений. Для файловых систем, нечувствительных к регистру букв, преобразует все буквы к нижнему регистру. Под Windows также заменяет символы косой черты (os.altsep) на символы обратной косой черты (os.sep).

normpath( path)

Возвращает нормализованное имя пути path. Эта функция сворачивает излишние разделители и ссылки на текущий и родительский каталоги, то есть имена путей A B, A/./B и A/foo/../B преобразуются к A/B. Под Windows также заменяет символы косой черты (os.altsep) на символы обратной косой черты (os.sep). Функция normpath() не нормализует регистр букв - для этих целей используйте функцию normcase() .

samefile( pathl, path2) (UNIX, Macintosh)

Возвращает 1 , если оба пути ссылаются на один и тот же файл (каталог), иначе возвращает 0. Генерирует исключение lOError, если вызов os.stat() для какого-либо пути заканчивается ошибкой.

sameopenfile( filel, file2) (UNIX, Macintosh)

Возвращает 1 , если файловые объекты filel и file2 ссылаются на один и тот же файл (файловые объекты могут представлять разные файловые дескрипторы), иначе возвращает 0 .

samestat( statl, stat2) (UNIX, Macintosh)

Возвращает 1 , если кортежи statl и stat2 (результат, возвращаемый функциями fstat() , lstat() и stat() ) ссылаются на один и тот же файл.

split( path)

Разбивает имя пути path на пару строк (head, tail), где tail - последний компонент пути и head - остальная часть пути. tail никогда не содержит символа os.sep: если путь path заканчивается этим символом, tail будет пустой строкой. Завершающие символы os.sep в head отбрасываются, за исключением случаев, когда path ссылается на корневой каталог. В любом случае join( head, tail) дает путь, эквивалентный path.

21.3. stat - интерпретация os.stat() 283

splitdrive(path)

Разбивает имя пути path на пару строк (drive, tail), где drive - спецификатор логического диска или пустая строка и head - остальная часть пути. В системах, которые не используют спецификаторы логических дисков drive всегда является пустой строкой. В любом случае выражение drive + tail == path всегда верно.

splitext( path)

Разбивает имя пути path на пару строк ( root , ext ) так, чтобы выполнялось условие root + ext == path и строка ext была пустой или начиналась с точки и содержала не более одной точки.

walk( path, visit , arg)

Вызывает visit ( arg, dirname, names) для каждого каталога в дереве, начиная с path (включая каталог path). Аргумент dirname указывает имя каталога, для которого вызывается функция visit , а names является списком файлов и каталогов в каталоге dirname (os.listdir(dirname), то есть используется путь относительно каталога dirname). Функция visit может вносить изменения в names и, тем самым, оказывать влияние на то, какие каталоги будут посещаться далее по дереву, то есть чтобы избежать посещения каких-либо частей дерева каталогов.

21.3 stat - интерпретация os.stat()

Этот модуль определяет константы и функции, необходимые для интерпретации элементов кортежа ( st mode, st ino, st dev, st nlink, st uid, st gid, st size, st atime, st mtime, st ctime ...) , возвращаемого функциями os.statO , os.lstatO и os.fstat() .

S ISDIR( st mode)

Истина, если аргумент st mode получен для каталога. S ISCHR( st mode)

Истина, если аргумент st mode получен для специального файла, представляющего устройство посимвольного ввода/вывода.

S ISBLK( st mode)

Истина, если аргумент st mode получен для специального файла, представляющего блочное устройство.

S ISREG( st mode)

Истина, если аргумент st mode получен для обычного файла.

S ISFIFO( st mode)

Истина, если аргумент st mode получен для именованного канала (FIFO).