Программирование на языке Ruby
вернуться

Фултон Хэл
Шрифт:

Если в потоке нет данных, но при этом достигнут конец файла, то

readpartial
немедленно возбуждает исключение
EOFError
.

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

EOFError
.

При вызове метода

sysread
в блокирующем режиме он ведет себя похоже на
readpartial
. Если буфер пуст, их поведение вообще идентично.

10.1.17. Манипулирование путевыми именами

Основными методами для работы с путевыми именами являются методы класса

File.dirname
и
File.basename
; они работают, как одноименные команды UNIX, то есть возвращают имя каталога и имя файла соответственно. Если вторым параметром методу
basename
передана строка с расширением имени файла, то это расширение исключается.

str = "/home/dave/podbay.rb"

dir = File.dirname(str) # "/home/dave"

file1 = File.basename(str) # "podbay.rb"

file2 = File.basename(str,".rb") # "podbay"

Хотя это методы класса

File
, на самом деле они просто манипулируют строками.

Упомянем также метод

File.split
, который возвращает обе компоненты (имя каталога и имя файла) в массиве из двух элементов:

info = File.split(str) # ["/home/dave","podbay.rb"]

Метод класса

expand_path
преобразует путевое имя в абсолютный путь. Если операционная система понимает сокращения
~
и
~user
, то они тоже учитываются.

Dir.chdir("/home/poole/personal/docs")

abs = File.expand_path("../../misc") # "/home/poole/misc"

Если передать методу

path
открытый файл, то он вернет путевое имя, по которому файл был открыт.

file = File.new("../../foobar")

name = file.path # "../../foobar"

Константа

File::Separator
равна символу, применяемому для разделения компонентов путевого имени (в Windows это обратная косая черта, а в UNIX — прямая косая черта). Имеется также синоним
File::SEPARATOR
.

Метод класса

join
использует этот разделитель для составления полного путевого имени из переданного списка компонентов:

path = File.join("usr","local","bin","someprog")

# path равно "usr/local/bin/someprog".

# Обратите внимание, что в начало имени разделитель не добавляется!

Не думайте, что методы

File.join
и
File.split
взаимно обратны, — это не так.

10.1.18. Класс Pathname

Следует знать о существовании стандартной библиотеки

pathname
, которая предоставляет класс
Pathname
. В сущности, это обертка вокруг классов
Dir
,
File
,
FileTest
и
FileUtils
, поэтому он комбинирует многие их функции логичным и интуитивно понятным способом.

path = Pathname.new("/home/hal")

file = Pathname.new("file.txt")

p2 = path + file

path.directory? # true

path.file? # false

p2.directory? # false

p2.file? # true

parts = path2.split # [Путевое имя:/home/hal, Путевое имя:file.txt]

ext = path2.extname # .txt

Как и следовало ожидать, имеется ряд вспомогательных методов. Метод

root?
пытается выяснить, относится ли данный путь к корневому каталогу, но его можно «обмануть», так как он просто анализирует строку, не обращаясь к файловой системе. Метод
parent?
возвращает путевое имя родительского каталога данного пути. Метод
children
возвращает непосредственных потомков каталога, заданного своим путевым именем; в их число включаются как файлы, так и каталоги, но рекурсивного спуска не производится.

p1 = Pathname.new("//") # Странно, но допустимо.

p1.root? # true

р2 = Pathname.new("/home/poole")

p3 = p2.parent # Путевое имя:/home

items = p2.children # Массив объектов Pathname

# (все файлы и каталоги, являющиеся

# непосредственными потомками р2).

Как и следовало ожидать, методы

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