os.listdir ()

os.listdir ( path=' . ' )

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

path может быть похожим на путь объектом (path-like object). Если path имеет тип bytes (прямо или косвенно через интерфейс PathLike), возвращаемые имена файлов также будут иметь тип bytes; во всех остальных случаях они будут типа str.

Эта функция также может поддерживать указание дескриптора файла; дескриптор файла должен ссылаться на каталог.

Вызывает событие аудита os.listdir с аргументом path.

Чтобы закодировать имена файлов str в bytes, используйте fsencode ().

Смотрите также: функция scandir () возвращает записи каталога вместе с информацией об атрибутах файла, обеспечивая лучшую производительность для многих распространенных случаев использования.

Изменено в версии 3.2: параметр path стал необязательным.

Новое в версии 3.3: добавлена поддержка указания path в качестве дескриптора открытого файла.

Изменено в версии 3.6: Принимает объект, подобный пути (path-like object).