Файловая система

Base.Filesystem.pwdФункция

pwd() -> AbstractString

Получить текущую рабочую директорию.

Base.Filesystem.cdМетод

cd(dir::AbstractString=homedir())

Установить текущую рабочую директорию.

Base.Filesystem.cdМетод

cd(f::Function, dir::AbstractString=homedir())

Временное изменение текущей рабочей директории и применение функции f перед возвратом.

Base.Filesystem.readdirФункция

readdir(dir::AbstractString=".") -> Vector{String}

Возвращает файлы и директории в директории dir (или текущую рабочую директорию, если не указана).

Base.Filesystem.walkdirФункция

walkdir(dir; topdown=true, follow_symlinks=false, onerror=throw)

Метод walkdir возвращает итератор, который обходит древовидную структуру директорий. Итератор возвращает кортеж, содержащий (rootpath, dirs, files). Дерево директорий можно обходить сверху вниз или снизу вверх. Если walkdir сталкивается с SystemError, по умолчанию произойдёт повторное выброс ошибки. Обработку ошибок можно настроить с помощью ключевого аргумента onerror. onerror вызывается с SystemError в качестве аргумента.

for (root, dirs, files) in walkdir(".")
    println("Directories in $root")
    for dir in dirs
        println(joinpath(root, dir)) # path to directories
    end
    println("Files in $root")
    for file in files
        println(joinpath(root, file)) # path to files
    end
end

Base.Filesystem.mkdirФункция

mkdir(path::AbstractString, mode::Unsigned=0o777)

Создать новую директорию с именем path и разрешениями mode. mode по умолчанию 0o777, изменяется текущей маской создания файлов. Эта функция никогда не создает более одной директории. Если директория уже существует, или некоторые промежуточные директории отсутствуют, функция выдаст ошибку. Смотрите mkpath для функции, которая создает все необходимые промежуточные директории.

Base.Filesystem.mkpathФункция

mkpath(path::AbstractString, mode::Unsigned=0o777)

Создать все директории в заданном path, с разрешениями mode. mode по умолчанию 0o777, изменяется текущей маской создания файлов.

Base.Filesystem.symlinkФункция

symlink(target::AbstractString, link::AbstractString)

Создаёт символическую ссылку на target с именем link.

Base.Filesystem.readlinkФункция

readlink(path::AbstractString) -> AbstractString

Возвращает целевое расположение символической ссылки path.

Base.Filesystem.chmodФункция

chmod(path::AbstractString, mode::Integer; recursive::Bool=false)

Изменить режим разрешений для path на mode. В настоящее время поддерживаются только целочисленные значения mode (например, 0o777). Если recursive=true и путь является директорией, все разрешения в этой директории будут изменены рекурсивно.

Base.Filesystem.chownФункция

chown(path::AbstractString, owner::Integer, group::Integer=-1)

Изменить владельца и/или группу path на owner и/или group. Если введенное значение для owner или group равно -1, соответствующий идентификатор не изменится. В настоящее время поддерживаются только целочисленные значения owner и group.

Base.statФункция

stat(file)

Возвращает структуру, поля которой содержат информацию о файле. Поля структуры:

Base.Filesystem.lstatФункция

lstat(file)

Аналогично stat, но для символических ссылок получает информацию о самой ссылке, а не о файле, на который она ссылается. Эту функцию необходимо вызывать для пути к файлу, а не для объекта файла или дескриптора файла.

Base.Filesystem.ctimeФункция

ctime(file)

Эквивалентно stat(file).ctime

Base.Filesystem.mtimeФункция

mtime(file)

Эквивалентно stat(file).mtime.

Base.Filesystem.filemodeФункция

filemode(file)

Эквивалентно stat(file).mode

Base.Filesystem.filesizeФункция

filesize(path...)

Эквивалентно stat(file).size.

Base.Filesystem.upermФункция

uperm(file)

Получает разрешения владельца файла в виде битового поля:

Для допустимых аргументов см. stat.

Base.Filesystem.gpermФункция

gperm(file)

Аналогично uperm, но получает разрешения группы, владеющей файлом.

Base.Filesystem.opermФункция

operm(file)

Аналогично uperm, но получает разрешения для пользователей, не являющихся ни владельцами файла, ни членами группы, владеющей файлом.

Base.Filesystem.cpФункция

cp(src::AbstractString, dst::AbstractString; remove_destination::Bool=false, follow_symlinks::Bool=false)

Копирует файл, ссылку или директорию из src в dest. remove_destination=true сначала удалит существующий dst.

Если follow_symlinks=false, и src является символической ссылкой, dst будет создан как символическая ссылка. Если follow_symlinks=true и src является символической ссылкой, dst будет копией файла или директории, на которую ссылается src.

Base.downloadФункция

download(url::AbstractString, [localfile::AbstractString])

Загрузить файл из заданного url, при необходимости переименовав его в заданное имя локального файла. Обратите внимание, что эта функция полагается на доступность внешних инструментов, таких как curl, wget или fetch, для загрузки файла и предоставлена для удобства. Для использования в производстве или в ситуациях, когда требуется больше опций, используйте пакет, предоставляющий желаемую функциональность.

Base.Filesystem.mvФункция

mv(src::AbstractString, dst::AbstractString; remove_destination::Bool=false)

Переместить файл, ссылку или директорию из src в dst. remove_destination=true сначала удалит существующий dst.

Base.Filesystem.rmФункция

rm(path::AbstractString; force::Bool=false, recursive::Bool=false)

Удалить файл, ссылку или пустую директорию по заданному пути. Если force=true передано, несуществующий путь не обрабатывается как ошибка. Если recursive=true передано и путь является директорией, тогда все содержимое удаляется рекурсивно.

Base.Filesystem.touchФункция

touch(path::AbstractString)

Обновить отметку времени последнего изменения файла на текущее время.

Base.Filesystem.tempnameФункция

tempname()

Сгенерировать уникальный временный путь к файлу.

Base.Filesystem.tempdirФункция

tempdir()

Получить путь к временной директории (возможно, общей с другими процессами).

Base.Filesystem.mktempМетод

mktemp(parent=tempdir())

Возвращает (path, io), где path — путь к новому временному файлу в parent, и io — открытый объект файла для этого пути.

Base.Filesystem.mktempМетод

mktemp(f::Function, parent=tempdir())

Применить функцию f к результату mktemp(parent) и удалить временный файл по завершении.

Base.Filesystem.mktempdirМетод

mktempdir(parent=tempdir())

Создать временную директорию в директории parent и вернуть её путь. Если parent не существует, выбросить ошибку.

Base.Filesystem.mktempdirМетод

mktempdir(f::Function, parent=tempdir())

Применить функцию f к результату mktempdir(parent) и удалить временную директорию по завершении.

Base.Filesystem.isblockdevФункция

isblockdev(path) -> Bool

Возвращает true если path — это блок-устройство, false в противном случае.

Base.Filesystem.ischardevФункция

ischardev(path) -> Bool

Возвращает true если path — это символьное устройство, false в противном случае.

Base.Filesystem.isdirФункция

isdir(path) -> Bool

Возвращает true если path — это директория, false в противном случае.

Base.Filesystem.isfifoФункция

isfifo(path) -> Bool

Возвращает true если path — это FIFO, false в противном случае.

Base.Filesystem.isfileФункция

isfile(path) -> Bool

Возвращает true если path — это обычный файл, false в противном случае.

Base.Filesystem.islinkФункция

islink(path) -> Bool

Возвращает true если path — это символическая ссылка, false в противном случае.

Base.Filesystem.ismountФункция

ismount(path) -> Bool

Возвращает true если path — это точка монтирования, false в противном случае.

Base.Filesystem.ispathФункция

ispath(path) -> Bool

Возвращает true если path — это допустимый путь к файловой системе, false в противном случае.

Base.Filesystem.issetgidФункция

issetgid(path) -> Bool

Возвращает true если path имеет установленный флаг setgid, false в противном случае.

Base.Filesystem.issetuidФункция

issetuid(path) -> Bool

Возвращает true если path имеет установленный флаг setuid, false в противном случае.

Base.Filesystem.issocketФункция

issocket(path) -> Bool

Возвращает true если path — это сокет, false в противном случае.

Base.Filesystem.isstickyФункция

issticky(path) -> Bool

Возвращает true если у path установлен флаг sticky, false в противном случае.

Base.Filesystem.homedirФункция

homedir() -> AbstractString

Возвращает домашний каталог текущего пользователя.

Base.Filesystem.dirnameФункция

dirname(path::AbstractString) -> AbstractString

Получить часть пути, относящуюся к каталогу.

julia> dirname("/home/myuser")
"/home"

См. также: basename

Base.Filesystem.basenameФункция

basename(path::AbstractString) -> AbstractString

Получить часть пути, относящуюся к имени файла.

julia> basename("/home/myuser/example.jl")
"example.jl"

См. также: dirname

Base.@__FILE__Макрос

@__FILE__ -> AbstractString

@__FILE__ расширяется до строки с абсолютным путём файла, содержащего макрос. Возвращает nothing при запуске из REPL или пустую строку, если вычислено julia -e <expr>. В качестве альтернативы см. PROGRAM_FILE.

Base.@__DIR__Макрос

@__DIR__ -> AbstractString

@__DIR__ расширяется до строки с частью пути каталога абсолютного пути файла, содержащего макрос. Возвращает nothing при запуске из REPL или пустую строку, если вычислено julia -e <expr>.

@__LINE__Макрос

@__LINE__ -> Int

@__LINE__ расширяется до номера строки места вызова.

Base.Filesystem.isabspathФункция

isabspath(path::AbstractString) -> Bool

Определяет, является ли путь абсолютным (начинается с корневого каталога).

julia> isabspath("/home")
true

julia> isabspath("home")
false

Base.Filesystem.isdirpathФункция

isdirpath(path::AbstractString) -> Bool

Определяет, ссылается ли путь на каталог (например, заканчивается разделителем путей).

julia> isdirpath("/home")
false

julia> isdirpath("/home/")
true

Base.Filesystem.joinpathФункция

joinpath(parts...) -> AbstractString

Объединяет компоненты пути в полный путь. Если какой-то аргумент — абсолютный путь, то предыдущие компоненты отбрасываются.

julia> joinpath("/home/myuser","example.jl")
"/home/myuser/example.jl"

Base.Filesystem.abspathФункция

abspath(path::AbstractString) -> AbstractString

Преобразует путь в абсолютный путь, добавляя текущий каталог при необходимости.

abspath(path::AbstractString, paths::AbstractString...) -> AbstractString

Преобразует набор путей в абсолютный путь, объединяя их и добавляя текущий каталог при необходимости. Эквивалентно abspath(joinpath(path, paths...)).

Base.Filesystem.normpathФункция

normpath(path::AbstractString) -> AbstractString

Нормализует путь, удаляя записи «.» и «..».

julia> normpath("/home/myuser/../example.jl")
"/home/example.jl"

Base.Filesystem.realpathФункция

realpath(path::AbstractString) -> AbstractString

Канонизирует путь, расширяя символические ссылки и удаляя записи «.» и «..».

Base.Filesystem.relpathФункция

relpath(path::AbstractString, startpath::AbstractString = ".") -> AbstractString

Возвращает относительный путь к path, либо от текущего каталога, либо от необязательного начального каталога. Это вычисление пути: доступ к файловой системе не используется для подтверждения существования или характера path или startpath.

Base.Filesystem.expanduserФункция

expanduser(path::AbstractString) -> AbstractString

В системах Unix заменяет символ тильды в начале пути на домашний каталог текущего пользователя.

Base.Filesystem.splitdirФункция

splitdir(path::AbstractString) -> (AbstractString, AbstractString)

Разделяет путь на кортеж из имени каталога и имени файла.

julia> splitdir("/home/myuser")
("/home", "myuser")

Base.Filesystem.splitdriveФункция

splitdrive(path::AbstractString) -> (AbstractString, AbstractString)

В Windows разделяет путь на букву диска и часть пути. В системах Unix первая составляющая всегда пустая строка.

Base.Filesystem.splitextФункция

splitext(path::AbstractString) -> (AbstractString, AbstractString)

Если последняя составляющая пути содержит точку, разделяет путь на всё до точки и всё, включая и после точки. В противном случае возвращает кортеж из аргумента без изменений и пустой строки.

julia> splitext("/home/myuser/example.jl")
("/home/myuser/example", ".jl")

julia> splitext("/home/myuser/example")
("/home/myuser/example", "")