Директория
Операции с директорией.
Функции, относительные к директории (open и т.д.), используют интерфейс *at на FreeBSD и Linux. Он недоступен на OS X до версии 10.10, поэтому не используется. На FreeBSD это позволяет функциям, относительным к директории, использовать Capsicum.
class ref Directory
Конструкторы
create
Возбудит ошибку, если путь не существует, не является директорией или нет разрешений на чтение файла или получение информации о файле.
new ref create( from: FilePath val) : Directory ref^ ?
Параметры
- from: FilePath val
Возвращаемое значение
- Directory ref^ ?
Открытые поля
let path: FilePath val
Это путь к директории в файловой системе и объект, предоставляющий доступ к операциям с этой директорией.
Открытые функции
entries
Список файлов в директории, без рекурсии. Путь к файлу будет относительным к директории, без разделителей директорий. Элементы «.» и «..» не будут включены.
fun box entries() : Array[String val] iso^ ?
Возвращаемое значение
open
Открыть директорию, относительно текущей. Возбуждает ошибку, если путь не находится внутри этой иерархии директорий.
fun box open( target: String val) : Directory iso^ ?
Параметры
- target: Строка val
Возвращаемое значение
- Directory iso^ ?
mkdir
Создать директорию относительно текущей. Возвращает false, если путь не находится внутри этой иерархии директорий или нет разрешения на создание директории.
fun box mkdir( target: String val) : Bool val
Параметры
- target: Строка val
Возвращаемое значение
- Булево val
create_file
Открыть для чтения/записи, создавая, если не существует, сохраняя содержимое, если оно уже существует.
fun box create_file( target: String val) : File iso^ ?
Параметры
- target: Строка val
Возвращаемое значение
- Файл iso^ ?
open_file
Открыть только для чтения, с ошибкой, если не существует.
fun box open_file( target: String val) : File iso^ ?
Параметры
- target: Строка val
Возвращаемое значение
- Файл iso^ ?
info
Возвращает FileInfo для этой директории. Возбуждает ошибку, если дескриптор недействителен или нет разрешений на получение информации о файле.
fun box info() : FileInfo val ?
Возвращаемое значение
- FileInfo val ?
chmod
Установить FileMode для этой директории.
fun box chmod( mode: FileMode box) : Bool val
Параметры
- mode: FileMode box
Возвращаемое значение
- Булево val
chown
Установить владельца и группу для этой директории. Не выполняет никаких действий в Windows.
fun box chown( uid: U32 val, gid: U32 val) : Bool val
Параметры
Возвращаемое значение
- Булево val
touch
Установить время последнего доступа и изменения директории на текущее.
fun box touch() : Bool val
Возвращаемое значение
- Булево val
set_time
Установить время последнего доступа и изменения директории на заданные значения.
fun box set_time( atime: (I64 val , I64 val), mtime: (I64 val , I64 val)) : Bool val
Параметры
Возвращаемое значение
- Булево val
infoat
Возвращает FileInfo для пути, относительного к этой директории.
fun box infoat( target: String val) : FileInfo val ?
Параметры
- target: Строка val
Возвращаемое значение
- FileInfo val ?
chmodat
Установить FileMode для пути, относительного к этой директории.
fun box chmodat( target: String val, mode: FileMode box) : Bool val
Параметры
Возвращаемое значение
- Булево val
chownat
Установить FileMode для пути, относительного к этой директории.
fun box chownat( target: String val, uid: U32 val, gid: U32 val) : Bool val
Параметры
Возвращаемое значение
- Булево val
touchat
Установить время последнего доступа и изменения директории на текущее.
fun box touchat( target: String val) : Bool val
Параметры
- target: Строка val
Возвращаемое значение
- Булево val
set_time_at
Установить время последнего доступа и изменения директории на заданные значения.
fun box set_time_at( target: String val, atime: (I64 val , I64 val), mtime: (I64 val , I64 val)) : Bool val
Параметры
Возвращаемое значение
- Булево val
symlink
Создать символическую ссылку на исходный путь, где имя ссылки относительно этой директории.
fun box symlink( source: FilePath val, link_name: String val) : Bool val
Параметры
Возвращаемое значение
- Булево val
remove
Удалить файл или директорию. Содержимое директории также будет удалено рекурсивно. Символические ссылки будут удалены, но не будут обработаны.
fun box remove( target: String val) : Bool val
Параметры
- target: Строка val
Возвращаемое значение
- Булево val
rename
Переименовать исходный файл (относительно этой директории) в целевой файл (относительно to директории).
fun box rename( source: String val, to: Directory box, target: String val) : Bool val
Параметры
Возвращаемое значение
- Булево val
dispose
Закрыть директорию.
fun ref dispose() : None val
Возвращаемое значение
- None val
© 2016-2020, The Pony Developers
© 2014-2015, Causality Ltd.
Licensed under the BSD 2-Clause License.
https://stdlib.ponylang.io/files-Directory