`stat.md`

292 строк · 13.4 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/library/stat.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 10.3. [`stat`](https://python-all.ru/2.7/library/stat.html#module-stat) – Интерпретация [`stat()`](https://python-all.ru/2.7/library/os.html#os.stat) результатов89**Исходный код:** [Lib/stat.py](https://python-all.ru/src/2.7/Lib/stat.py)1011---1213Модуль [`stat`](https://python-all.ru/2.7/library/stat.html#module-stat) определяет константы и функции для интерпретации результатов [`os.stat()`](https://python-all.ru/2.7/library/os.html#os.stat), [`os.fstat()`](https://python-all.ru/2.7/library/os.html#os.fstat) и [`os.lstat()`](https://python-all.ru/2.7/library/os.html#os.lstat) (если они существуют). За полными сведениями о вызовах `stat()`, `fstat()` и `lstat()` обращайтесь к документации вашей системы.1415Модуль [`stat`](https://python-all.ru/2.7/library/stat.html#module-stat) определяет следующие функции для проверки определённых типов файлов:1617#### `stat.S_ISDIR(mode)`1819Возвращает ненулевое значение, если режим соответствует каталогу.2021#### `stat.S_ISCHR(mode)`2223Возвращает ненулевое значение, если режим соответствует файлу символьного устройства.2425#### `stat.S_ISBLK(mode)`2627Возвращает ненулевое значение, если режим соответствует файлу блочного устройства.2829#### `stat.S_ISREG(mode)`3031Возвращает ненулевое значение, если режим соответствует обычному файлу.3233#### `stat.S_ISFIFO(mode)`3435Возвращает ненулевое значение, если режим соответствует FIFO (именованному каналу).3637#### `stat.S_ISLNK(mode)`3839Возвращает ненулевое значение, если режим соответствует символической ссылке.4041#### `stat.S_ISSOCK(mode)`4243Возвращает ненулевое значение, если режим соответствует сокету.4445Определены ещё две функции для более общей работы с режимом файла:4647#### `stat.S_IMODE(mode)`4849Возвращает часть режима файла, которая может быть установлена с помощью [`os.chmod()`](https://python-all.ru/2.7/library/os.html#os.chmod) – то есть биты разрешений файла, плюс sticky-бит, биты set-group-id и set-user-id (в системах, которые их поддерживают).5051#### `stat.S_IFMT(mode)`5253Возвращает часть режима файла, описывающую тип файла (используется функциями `S_IS*()` выше).5455Обычно для проверки типа файла используются функции `os.path.is*()`; приведённые здесь функции полезны, когда выполняется несколько проверок одного и того же файла и хочется избежать накладных расходов на системный вызов `stat()` для каждой проверки. Они также полезны при получении информации о файле, которая не обрабатывается [`os.path`](https://python-all.ru/2.7/library/os.path.html#module-os.path), например, при проверке блочных и символьных устройств.5657Пример:5859```python60import os, sys61from stat import *6263def walktree(top, callback):64    '''рекурсивно обойти дерево каталогов, начиная с top,65       вызов функции обратного вызова для каждого обычного файла'''6667    for f in os.listdir(top):68        pathname = os.path.join(top, f)69        mode = os.stat(pathname).st_mode70        if S_ISDIR(mode):71            # Это каталог, рекурсивно зайти в него72            walktree(pathname, callback)73        elif S_ISREG(mode):74            # Это файл, вызвать функцию обратного вызова75            callback(pathname)76        else:77            # Неизвестный тип файла, вывести сообщение78            print 'Skipping %s' % pathname7980def visitfile(file):81    print 'visiting', file8283if __name__ == '__main__':84    walktree(sys.argv[1], visitfile)85```8687Все приведенные ниже переменные – это просто символические индексы кортежа из 10 элементов, возвращаемого функциями [`os.stat()`](https://python-all.ru/2.7/library/os.html#os.stat), [`os.fstat()`](https://python-all.ru/2.7/library/os.html#os.fstat) или [`os.lstat()`](https://python-all.ru/2.7/library/os.html#os.lstat).8889#### `stat.ST_MODE`9091Режим защиты inode.9293#### `stat.ST_INO`9495Номер inode.9697#### `stat.ST_DEV`9899Устройство, на котором находится inode.100101#### `stat.ST_NLINK`102103Количество ссылок на inode.104105#### `stat.ST_UID`106107Идентификатор пользователя владельца.108109#### `stat.ST_GID`110111Идентификатор группы владельца.112113#### `stat.ST_SIZE`114115Размер обычного файла в байтах; количество данных, ожидающих чтения на некоторых специальных файлах.116117#### `stat.ST_ATIME`118119Время последнего доступа.120121#### `stat.ST_MTIME`122123Время последнего изменения.124125#### `stat.ST_CTIME`126127«ctime» в том виде, в котором он сообщается операционной системой. В некоторых системах (например, Unix) это время последнего изменения метаданных, а в других (например, Windows) – время создания (подробнее см. документацию платформы).128129Интерпретация «размера файла» зависит от типа файла. Для обычных файлов это размер файла в байтах. Для FIFO и сокетов в большинстве разновидностей Unix (включая Linux) «размер» – это количество байтов, ожидающих чтения на момент вызова [`os.stat()`](https://python-all.ru/2.7/library/os.html#os.stat), [`os.fstat()`](https://python-all.ru/2.7/library/os.html#os.fstat) или [`os.lstat()`](https://python-all.ru/2.7/library/os.html#os.lstat); это иногда может быть полезно, особенно для опроса одного из таких специальных файлов после неблокирующего открытия. Смысл поля размера для других символьных и блочных устройств варьируется сильнее в зависимости от реализации нижележащего системного вызова.130131Приведенные ниже переменные определяют флаги, используемые в поле [`ST_MODE`](https://python-all.ru/2.7/library/stat.html#stat.ST_MODE).132133Использование приведенных выше функций более переносимо, чем использование первого набора флагов:134135#### `stat.S_IFSOCK`136137Сокет.138139#### `stat.S_IFLNK`140141Символическая ссылка.142143#### `stat.S_IFREG`144145Обычный файл.146147#### `stat.S_IFBLK`148149Блочное устройство.150151#### `stat.S_IFDIR`152153Каталог.154155#### `stat.S_IFCHR`156157Символьное устройство.158159#### `stat.S_IFIFO`160161FIFO.162163Следующие флаги также можно использовать в аргументе *mode* функции [`os.chmod()`](https://python-all.ru/2.7/library/os.html#os.chmod):164165#### `stat.S_ISUID`166167Бит setuid.168169#### `stat.S_ISGID`170171Бит set-group-ID. Этот бит имеет несколько особых применений. Для каталога\\nон указывает, что для этого каталога используется семантика BSD:\\nсоздаваемые в нём файлы наследуют свой идентификатор группы от каталога, а не\\nот эффективного идентификатора группы создающего процесса, а создаваемые там\\nкаталоги также будут иметь установленный бит [`S_ISGID`](https://python-all.ru/2.7/library/stat.html#stat.S_ISGID). Для\\nфайла, у которого не установлен бит выполнения для группы ([`S_IXGRP`](https://python-all.ru/2.7/library/stat.html#stat.S_IXGRP)),\\nбит set-group-ID указывает на обязательную блокировку файлов/записей\\n(см. также [`S_ENFMT`](https://python-all.ru/2.7/library/stat.html#stat.S_ENFMT)).172173#### `stat.S_ISVTX`174175Sticky bit. Когда этот бит установлен для каталога, это означает, что файл\\nв этом каталоге может быть переименован или удалён только владельцем\\nфайла, владельцем каталога или привилегированным процессом.176177#### `stat.S_IRWXU`178179Маска для прав владельца файла.180181#### `stat.S_IRUSR`182183Владелец имеет право на чтение.184185#### `stat.S_IWUSR`186187Владелец имеет право на запись.188189#### `stat.S_IXUSR`190191Владелец имеет право на выполнение.192193#### `stat.S_IRWXG`194195Маска для прав группы.196197#### `stat.S_IRGRP`198199Группа имеет право на чтение.200201#### `stat.S_IWGRP`202203Группа имеет право на запись.204205#### `stat.S_IXGRP`206207Группа имеет право на выполнение.208209#### `stat.S_IRWXO`210211Маска прав для остальных (не входящих в группу).212213#### `stat.S_IROTH`214215Остальные имеют право на чтение.216217#### `stat.S_IWOTH`218219Остальные имеют право на запись.220221#### `stat.S_IXOTH`222223Остальные имеют право на выполнение.224225#### `stat.S_ENFMT`226227Принудительная блокировка файлов System V. Этот флаг разделяется с [`S_ISGID`](https://python-all.ru/2.7/library/stat.html#stat.S_ISGID): блокировка файлов/записей применяется к файлам, у которых не установлен бит выполнения группы ([`S_IXGRP`](https://python-all.ru/2.7/library/stat.html#stat.S_IXGRP)).228229#### `stat.S_IREAD`230231Синоним Unix V7 для [`S_IRUSR`](https://python-all.ru/2.7/library/stat.html#stat.S_IRUSR).232233#### `stat.S_IWRITE`234235Синоним Unix V7 для [`S_IWUSR`](https://python-all.ru/2.7/library/stat.html#stat.S_IWUSR).236237#### `stat.S_IEXEC`238239Синоним Unix V7 для [`S_IXUSR`](https://python-all.ru/2.7/library/stat.html#stat.S_IXUSR).240241Следующие флаги можно использовать в аргументе *flags* функции [`os.chflags()`](https://python-all.ru/2.7/library/os.html#os.chflags):242243#### `stat.UF_NODUMP`244245Не сбрасывать файл в дамп.246247#### `stat.UF_IMMUTABLE`248249Файл нельзя изменить.250251#### `stat.UF_APPEND`252253Файл можно только дополнять.254255#### `stat.UF_OPAQUE`256257Каталог непрозрачен при просмотре через стек объединения.258259#### `stat.UF_NOUNLINK`260261Файл нельзя переименовать или удалить.262263#### `stat.UF_COMPRESSED`264265Файл сохраняется в сжатом виде (Mac OS X 10.6+).266267#### `stat.UF_HIDDEN`268269Файл не должен отображаться в графическом интерфейсе (Mac OS X 10.5+).270271#### `stat.SF_ARCHIVED`272273Файл может быть архивирован.274275#### `stat.SF_IMMUTABLE`276277Файл нельзя изменить.278279#### `stat.SF_APPEND`280281Файл можно только дополнять.282283#### `stat.SF_NOUNLINK`284285Файл нельзя переименовать или удалить.286287#### `stat.SF_SNAPSHOT`288289Файл является снимком.290291Для получения дополнительной информации обратитесь к man-странице *chflags(2)* в системах \*BSD или Mac OS.292