класс File

Объект File представляет собой отображение файла в базовой платформе.

Класс File расширяет модуль FileTest, поддерживая такие одиночные методы, как File.exist?.

О примерах

Многие примеры здесь используют эти переменные:

# English text with newlines.
text = <<~EOT
  First line
  Second line

  Fourth line
  Fifth line
EOT

# Russian text.
russian = "\u{442 435 441 442}" # => "тест"

# Binary data.
data = "\u9990\u9991\u9992\u9993\u9994"

# Text file.
File.write('t.txt', text)

# File with Russian text.
File.write('t.rus', russian)

# File with binary data.
f = File.new('t.dat', 'wb:UTF-16')
f.write(data)
f.close

Режимы доступа

Методы File.new и File.open каждый создают объект File для заданного пути к файлу.

Строковые режимы доступа

Методы File.new и File.open каждый может принимать строковый аргумент mode, который:

• Начинается с 1- или 2-символьного режима чтения/записи.

• Может также содержать 1-символьный режим данных.

• Может также содержать 1-символьный режим создания файла.

Режим чтения/записи

Режим чтения/записи mode определяет:

• Следует ли изначально усекать файл.

• Разрешено ли чтение, и если да:

  • Начальная позиция чтения в файле.

  • Где в файле может происходить чтение.

• Разрешена ли запись, и если да:

  • Начальная позиция записи в файле.

  • Где в файле может происходить запись.

Эти таблицы суммируют:

Read/Write Modes for Existing File

|------|-----------|----------|----------|----------|-----------|
| R/W  | Initial   |          | Initial  |          | Initial   |
| Mode | Truncate? |  Read    | Read Pos |  Write   | Write Pos |
|------|-----------|----------|----------|----------|-----------|
| 'r'  |    No     | Anywhere |    0     |   Error  |     -     |
| 'w'  |    Yes    |   Error  |    -     | Anywhere |     0     |
| 'a'  |    No     |   Error  |    -     | End only |    End    |
| 'r+' |    No     | Anywhere |    0     | Anywhere |     0     |
| 'w+' |    Yes    | Anywhere |    0     | Anywhere |     0     |
| 'a+' |    No     | Anywhere |   End    | End only |    End    |
|------|-----------|----------|----------|----------|-----------|

Read/Write Modes for \File To Be Created

|------|----------|----------|----------|-----------|
| R/W  |          | Initial  |          | Initial   |
| Mode |  Read    | Read Pos |  Write   | Write Pos |
|------|----------|----------|----------|-----------|
| 'w'  |   Error  |    -     | Anywhere |     0     |
| 'a'  |   Error  |    -     | End only |     0     |
| 'w+' | Anywhere |    0     | Anywhere |     0     |
| 'a+' | Anywhere |    0     | End only |    End    |
|------|----------|----------|----------|-----------|

Обратите внимание, что режимы 'r' и 'r+' не допускаются для несуществующего файла (возбуждается исключение).

В таблицах:

• Anywhere означает, что методы IO#rewind, IO#pos= и IO#seek могут использоваться для изменения позиции файла, так что разрешенное чтение или запись могут происходить в любом месте файла.

• End only означает, что запись может происходить только в конце файла, и что методы IO#rewind, IO#pos= и IO#seek не влияют на запись.

• Error означает, что возбуждается исключение, если предпринята недопустимая попытка чтения или записи.

Режимы чтения/записи для существующего файла

• 'r':

  • File изначально не усекается:

    f = File.new('t.txt') # => #<File:t.txt>
    f.size == 0           # => false
    

  • Начальная позиция чтения файла равна 0:

    f.pos # => 0
    

  • File может читаться в любом месте; см. IO#rewind, IO#pos=, IO#seek:

    f.readline # => "First line\n"
    f.readline # => "Second line\n"
    
    f.rewind
    f.readline # => "First line\n"
    
    f.pos = 1
    f.readline # => "irst line\n"
    
    f.seek(1, :CUR)
    f.readline # => "econd line\n"
    

  • Запись не разрешена:

    f.write('foo') # Raises IOError.
    

• 'w':

  • File изначально усекается:

    path = 't.tmp'
    File.write(path, text)
    f = File.new(path, 'w')
    f.size == 0 # => true
    

  • Начальная позиция записи файла равна 0:

    f.pos # => 0
    

  • File может записываться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.write('foo')
    f.flush
    File.read(path) # => "foo"
    f.pos # => 3
    
    f.write('bar')
    f.flush
    File.read(path) # => "foobar"
    f.pos # => 6
    
    f.rewind
    f.write('baz')
    f.flush
    File.read(path) # => "bazbar"
    f.pos # => 3
    
    f.pos = 3
    f.write('foo')
    f.flush
    File.read(path) # => "bazfoo"
    f.pos # => 6
    
    f.seek(-3, :END)
    f.write('bam')
    f.flush
    File.read(path) # => "bazbam"
    f.pos # => 6
    
    f.pos = 8
    f.write('bah')  # Zero padding as needed.
    f.flush
    File.read(path) # => "bazbam\u0000\u0000bah"
    f.pos # => 11
    

  • Чтение не разрешено:

    f.read # Raises IOError.
    

• 'a':

  • File изначально не усекается:

    path = 't.tmp'
    File.write(path, 'foo')
    f = File.new(path, 'a')
    f.size == 0 # => false
    

  • Начальная позиция файла равна 0 (но игнорируется):

    f.pos # => 0
    

  • File может записываться только в конце файла; IO#rewind, IO#pos=, IO#seek не влияют на запись:

    f.write('bar')
    f.flush
    File.read(path) # => "foobar"
    f.write('baz')
    f.flush
    File.read(path) # => "foobarbaz"
    
    f.rewind
    f.write('bat')
    f.flush
    File.read(path) # => "foobarbazbat"
    

  • Чтение не разрешено:

    f.read # Raises IOError.
    

• 'r+':

  • File изначально не усекается:

    path = 't.tmp'
    File.write(path, text)
    f = File.new(path, 'r+')
    f.size == 0 # => false
    

  • Начальная позиция чтения файла равна 0:

    f.pos # => 0
    

  • File может читаться или записываться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.readline # => "First line\n"
    f.readline # => "Second line\n"
    
    f.rewind
    f.readline # => "First line\n"
    
    f.pos = 1
    f.readline # => "irst line\n"
    
    f.seek(1, :CUR)
    f.readline # => "econd line\n"
    
    f.rewind
    f.write('WWW')
    f.flush
    File.read(path)
    # => "WWWst line\nSecond line\nFourth line\nFifth line\n"
    
    f.pos = 10
    f.write('XXX')
    f.flush
    File.read(path)
    # => "WWWst lineXXXecond line\nFourth line\nFifth line\n"
    
    f.seek(-6, :END)
    # => 0
    f.write('YYY')
    # => 3
    f.flush
    # => #<File:t.tmp>
    File.read(path)
    # => "WWWst lineXXXecond line\nFourth line\nFifth YYYe\n"
    
    f.seek(2, :END)
    f.write('ZZZ') # Zero padding as needed.
    f.flush
    File.read(path)
    # => "WWWst lineXXXecond line\nFourth line\nFifth YYYe\n\u0000\u0000ZZZ"
    

• 'a+':

  • File изначально не усекается:

    path = 't.tmp'
    File.write(path, 'foo')
    f = File.new(path, 'a+')
    f.size == 0 # => false
    

  • Начальная позиция чтения файла равна 0:

    f.pos # => 0
    

  • File может записываться только в конце файла; IO#rewind, IO#pos=, IO#seek не влияют на запись:

    f.write('bar')
    f.flush
    File.read(path)      # => "foobar"
    f.write('baz')
    f.flush
    File.read(path)      # => "foobarbaz"
    
    f.rewind
    f.write('bat')
    f.flush
    File.read(path) # => "foobarbazbat"
    

  • File может читаться в любом месте; см. IO#rewind, IO#pos=, IO#seek:

    f.rewind
    f.read # => "foobarbazbat"
    
    f.pos = 3
    f.read # => "barbazbat"
    
    f.seek(-3, :END)
    f.read # => "bat"
    

Режимы чтения/записи для файла, который будет создан

Обратите внимание, что режимы 'r' и 'r+' не допускаются для несуществующего файла (возбуждается исключение).

• 'w':

  • Начальная позиция записи файла равна 0:

    path = 't.tmp'
    FileUtils.rm_f(path)
    f = File.new(path, 'w')
    f.pos # => 0
    

  • File может записываться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.write('foo')
    f.flush
    File.read(path) # => "foo"
    f.pos # => 3
    
    f.write('bar')
    f.flush
    File.read(path) # => "foobar"
    f.pos # => 6
    
    f.rewind
    f.write('baz')
    f.flush
    File.read(path) # => "bazbar"
    f.pos # => 3
    
    f.pos = 3
    f.write('foo')
    f.flush
    File.read(path) # => "bazfoo"
    f.pos # => 6
    
    f.seek(-3, :END)
    f.write('bam')
    f.flush
    File.read(path) # => "bazbam"
    f.pos # => 6
    
    f.pos = 8
    f.write('bah')  # Zero padding as needed.
    f.flush
    File.read(path) # => "bazbam\u0000\u0000bah"
    f.pos # => 11
    

  • Чтение не разрешено:

    f.read # Raises IOError.
    

• 'a':

  • Начальная позиция записи файла равна 0:

    path = 't.tmp'
    FileUtils.rm_f(path)
    f = File.new(path, 'a')
    f.pos # => 0
    

  • Запись происходит только в конце файла:

    f.write('foo')
    f.pos # => 3
    f.write('bar')
    f.pos # => 6
    f.flush
    File.read(path) # => "foobar"
    
    f.rewind
    f.write('baz')
    f.flush
    File.read(path) # => "foobarbaz"
    

  • Чтение не разрешено:

    f.read # Raises IOError.
    

• 'w+':

  • Начальная позиция файла равна 0:

    path = 't.tmp'
    FileUtils.rm_f(path)
    f = File.new(path, 'w+')
    f.pos # => 0
    

  • File может записываться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.write('foo')
    f.flush
    File.read(path) # => "foo"
    f.pos # => 3
    
    f.write('bar')
    f.flush
    File.read(path) # => "foobar"
    f.pos # => 6
    
    f.rewind
    f.write('baz')
    f.flush
    File.read(path) # => "bazbar"
    f.pos # => 3
    
    f.pos = 3
    f.write('foo')
    f.flush
    File.read(path) # => "bazfoo"
    f.pos # => 6
    
    f.seek(-3, :END)
    f.write('bam')
    f.flush
    File.read(path) # => "bazbam"
    f.pos # => 6
    
    f.pos = 8
    f.write('bah')  # Zero padding as needed.
    f.flush
    File.read(path) # => "bazbam\u0000\u0000bah"
    f.pos # => 11
    

  • File может читаться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.rewind
    # => 0
    f.read
    # => "bazbam\u0000\u0000bah"
    
    f.pos = 3
    # => 3
    f.read
    # => "bam\u0000\u0000bah"
    
    f.seek(-3, :END)
    # => 0
    f.read
    # => "bah"
    

• 'a+':

  • Начальная позиция записи файла равна 0:

    path = 't.tmp'
    FileUtils.rm_f(path)
    f = File.new(path, 'a+')
    f.pos # => 0
    

  • Запись происходит только в конце файла:

    f.write('foo')
    f.pos # => 3
    f.write('bar')
    f.pos # => 6
    f.flush
    File.read(path) # => "foobar"
    
    f.rewind
    f.write('baz')
    f.flush
    File.read(path) # => "foobarbaz"
    

  • File может читаться в любом месте (даже за пределы конца файла); см. IO#rewind, IO#pos=, IO#seek:

    f.rewind
    f.read # => "foobarbaz"
    
    f.pos = 3
    f.read # => "barbaz"
    
    f.seek(-3, :END)
    f.read # => "baz"
    
    f.pos = 800
    f.read # => ""
    

Режим данных

Чтобы указать, следует ли обрабатывать данные как текстовые или как двоичные, к любому из указанных выше строковых режимов чтения/записи может быть добавлен любой из следующих суффиксов:

• 't': Текстовые данные; устанавливает кодировку по умолчанию на Encoding::UTF_8; в Windows включает преобразование между EOL и CRLF и включает интерпретацию 0x1A как маркера конца файла.

• 'b': Двоичные данные; устанавливает кодировку по умолчанию на Encoding::ASCII_8BIT; в Windows подавляет преобразование между EOL и CRLF и отключает интерпретацию 0x1A как маркера конца файла.

Если ни один из них не задан, поток по умолчанию является текстовым.

Примеры:

File.new('t.txt', 'rt')
File.new('t.dat', 'rb')

Когда указан режим данных, режим чтения/записи не может быть опущен, а режим данных должен предшествовать режиму создания файла, если он задан:

File.new('t.dat', 'b')   # Raises an exception.
File.new('t.dat', 'rxb') # Raises an exception.

Режим создания файла

Следующее может быть добавлено к любому из указанных выше записываемых строковых режимов:

• 'x': Создает файл, если он не существует; вызывает исключение, если файл существует.

Пример:

File.new('t.tmp', 'wx')

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

File.new('t.dat', 'x')   # Raises an exception.
File.new('t.dat', 'rxb') # Raises an exception.

Целочисленные режимы доступа

Когда режим является целым числом, он должен быть одной или несколькими из следующих констант, которые могут быть объединены побитовым оператором OR |:

• File::RDONLY: Открыть только для чтения.

• File::WRONLY: Открыть только для записи.

• File::RDWR: Открыть для чтения и записи.

• File::APPEND: Открыть только для добавления.

Примеры:

File.new('t.txt', File::RDONLY)
File.new('t.tmp', File::RDWR | File::CREAT | File::EXCL)

Примечание: Method IO#set_encoding не позволяет указать режим как целое число.

Режим создания файла, указанный как целое число

Эти константы могут также быть объединены с помощью OR в целочисленный режим:

• File::CREAT: Создать файл, если он не существует.

• File::EXCL: Возбудить исключение, если File::CREAT задан и файл существует.

Режим данных, указанный как целое число

Режим данных не может быть указан как целое число. Когда режим доступа к потоку задан как целое число, режим данных всегда является текстовым, никогда не двоичным.

Обратите внимание, что хотя существует константа File::BINARY, установка ее значения в целочисленном режиме потока не оказывает никакого эффекта; это связано с тем, что, как задокументировано в File::Constants, значение File::BINARY отключает преобразование кода строки, но не изменяет внешнюю кодировку.

Кодировки

Любой из вышеперечисленных режимов строк может указать кодировки — либо только внешнюю кодировку, либо и внешнюю, и внутреннюю кодировки — добавив одно или оба имена кодировок, разделенные двоеточиями:

f = File.new('t.dat', 'rb')
f.external_encoding # => #<Encoding:ASCII-8BIT>
f.internal_encoding # => nil
f = File.new('t.dat', 'rb:UTF-16')
f.external_encoding # => #<Encoding:UTF-16 (dummy)>
f.internal_encoding # => nil
f = File.new('t.dat', 'rb:UTF-16:UTF-16')
f.external_encoding # => #<Encoding:UTF-16 (dummy)>
f.internal_encoding # => #<Encoding:UTF-16>
f.close

Множество имён кодировок доступно в массиве Encoding.name_list:

Encoding.name_list.take(3) # => ["ASCII-8BIT", "UTF-8", "US-ASCII"]

Когда установлена внешняя кодировка, считываемые строки помечаются этой кодировкой при чтении, а записываемые строки преобразуются в эту кодировку при записи.

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

Если внешняя кодировка равна 'BOM|UTF-8', 'BOM|UTF-16LE' или 'BOM|UTF16-BE', Ruby проверяет наличие BOM (Unicode Byte Order Mark) в входном документе, чтобы определить кодировку. Для кодировок UTF-16 режим открытия файла должен быть двоичным. Если BOM найден, он удаляется, и используется внешняя кодировка из BOM.

Обратите внимание, что кодировка BOM не чувствительна к регистру, поэтому 'bom|utf-8' также является допустимой.

Разрешения файлов

Объект File имеет разрешения, целочисленное значение в восьмеричной системе счисления, представляющее разрешения фактического файла в базовой платформе.

Обратите внимание, что разрешения файлов сильно отличаются от режима потока файла (объекта File). См. Режимы на IO.

В объекте File разрешения доступны таким образом, где метод mode, несмотря на своё имя, возвращает разрешения:

f = File.new('t.txt')
f.lstat.mode.to_s(8) # => "100644"

В операционной системе на основе Unix три младших восьмеричных цифры представляют разрешения для владельца (6), группы (4) и других (4). Три бита в каждой восьмеричной цифре представляют соответственно разрешения на чтение, запись и выполнение.

Разрешения 0644 таким образом представляют разрешения на чтение и запись для владельца и только на чтение для группы и других. См. страницы руководства open(2) и chmod(2).

Для каталога смысл бита выполнения меняется: при установке бита выполнение, каталог можно просматривать.

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

В операционных системах, не поддерживающих Posix, разрешения могут включать только чтение или чтение/запись, в этом случае оставшиеся разрешения будут соответствовать типичным значениям. Например, в Windows стандартные разрешения — 0644; единственное изменение, которое можно внести, — сделать файл только для чтения, что отображается как 0444.

Для метода, который фактически создаёт файл в базовой платформе (в отличие от просто создания объекта File), разрешения могут быть указаны:

File.new('t.tmp', File::CREAT, 0644)
File.new('t.tmp', File::CREAT, 0444)

Разрешения также можно изменить:

f = File.new('t.tmp', File::CREAT, 0444)
f.chmod(0644)
f.chmod(0444)

Константы файлов

Различные константы для использования в методах File и IO можно найти в модуле File::Constants; массив их имён возвращается методом File::Constants.constants.

Что здесь есть

Во-первых, что есть где-то ещё. Класс File:

• Наследуется от класса IO, в частности, методов для создания, чтения и записи файлов

• Включает модуль FileTest, который предоставляет десятки дополнительных методов.

Здесь класс File предоставляет методы, полезные для:

• Создание

• Запрос

• Настройки

• Другие

Создание

• ::new: Открывает файл по заданному пути; возвращает файл.

• ::open: То же, что и ::new, но при передаче блока передаёт файл в блок, а при выходе из блока закрывает файл.

• ::link: Создаёт новое имя для существующего файла с помощью жёсткой ссылки.

• ::mkfifo: Возвращает созданный FIFO-файл по заданному пути.

• ::symlink: Создаёт символическую ссылку для заданного пути файла.

Запрос

Пути

• ::absolute_path: Возвращает абсолютный путь к файлу для заданного пути.

• ::absolute_path?: Возвращает, является ли заданный путь абсолютным путем к файлу.

• ::basename: Возвращает последнюю компоненту заданного пути к файлу.

• ::dirname: Возвращает всё, кроме последней компоненты заданного пути к файлу.

• ::expand_path: Возвращает абсолютный путь к файлу для заданного пути, расширяя ~ для домашнего каталога.

• ::extname: Возвращает расширение файла для заданного пути к файлу.

• ::fnmatch? (алиас ::fnmatch): Возвращает, соответствует ли заданный путь к файлу заданному шаблону.

• ::join: Объединяет компоненты пути в строку пути.

• ::path: Возвращает строковое представление заданного пути.

• ::readlink: Возвращает путь к файлу по заданной символической ссылке.

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

• ::realpath: Возвращает реальный путь для заданного пути к файлу, где все компоненты должны существовать.

• ::split: Возвращает массив из двух строк: имя каталога и имя файла по заданному пути.

• path (алиас to_path): Возвращает строковое представление заданного пути.

Времена

• ::atime: Возвращает объект Time для последнего доступа к заданному файлу.

• ::birthtime: Возвращает объект Time для создания заданного файла.

• ::ctime: Возвращает объект Time для изменения метаданных заданного файла.

• ::mtime: Возвращает объект Time для последнего изменения данных содержимого заданного файла.

• atime: Возвращает объект Time для последнего доступа к self.

• birthtime: Возвращает объект Time для создания self.

• ctime: Возвращает объект Time для изменения метаданных self.

• mtime: Возвращает объект Time для последнего изменения данных содержимого self.

Типы

• ::blockdev?: Возвращает значение, указывающее, является ли файл по указанному пути блочным устройством.

• ::chardev?: Возвращает значение, указывающее, является ли файл по указанному пути символьным устройством.

• ::directory?: Возвращает значение, указывающее, является ли файл по указанному пути каталогом.

• ::executable?: Возвращает значение, указывающее, может ли файл по указанному пути быть выполнен эффективным пользователем и группой текущего процесса.

• ::executable_real?: Возвращает значение, указывающее, может ли файл по указанному пути быть выполнен реальным пользователем и группой текущего процесса.

• ::exist?: Возвращает значение, указывающее, существует ли файл по указанному пути.

• ::file?: Возвращает значение, указывающее, является ли файл по указанному пути обычным файлом.

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

• ::grpowned?: Возвращает значение, указывающее, принадлежит ли файл по указанному пути эффективной группе текущего процесса.

• ::identical?: Возвращает значение, указывающее, идентичны ли файлы по двум заданным путям.

• ::lstat: Возвращает объект File::Stat для последнего символической ссылки в заданном пути.

• ::owned?: Возвращает значение, указывающее, принадлежит ли файл по указанному пути эффективному пользователю текущего процесса.

• ::pipe?: Возвращает значение, указывающее, является ли файл по указанному пути FIFO.

• ::readable?: Возвращает значение, указывающее, может ли файл по указанному пути быть прочитан эффективным пользователем и группой текущего процесса.

• ::readable_real?: Возвращает значение, указывающее, может ли файл по указанному пути быть прочитан реальным пользователем и группой текущего процесса.

• ::setgid?: Возвращает значение, указывающее, установлен ли бит setgid для файла по указанному пути.

• ::setuid?: Возвращает значение, указывающее, установлен ли бит setuid для файла по указанному пути.

• ::socket?: Возвращает значение, указывающее, является ли файл по указанному пути сокетом.

• ::stat: Возвращает объект File::Stat для файла по указанному пути.

• ::sticky?: Возвращает значение, указывающее, установлен ли бит "sticky" для файла по указанному пути.

• ::symlink?: Возвращает значение, указывающее, является ли файл по указанному пути символической ссылкой.

• ::umask: Возвращает значение umask для текущего процесса.

• ::world_readable?: Возвращает значение, указывающее, может ли файл по указанному пути быть прочитан другими.

• ::world_writable?: Возвращает значение, указывающее, может ли файл по указанному пути быть изменён другими.

• ::writable?: Возвращает значение, указывающее, может ли файл по указанному пути быть изменён эффективным пользователем и группой текущего процесса.

• ::writable_real?: Возвращает значение, указывающее, может ли файл по указанному пути быть изменён реальным пользователем и группой текущего процесса.

• lstat: Возвращает объект File::Stat для последней символической ссылки в пути для self.

Содержание

• ::empty? (алиас ::zero?): Возвращает значение, указывающее, существует ли и пуст ли файл по указанному пути.

• ::size: Возвращает размер (в байтах) файла по указанному пути.

• ::size?: Возвращает nil если файла по указанному пути нет или он пуст; в противном случае возвращает размер файла в байтах.

• size: Возвращает размер (в байтах) self.

Настройки

• ::chmod: Изменяет разрешения файла по указанному пути.

• ::chown: Изменяет владельца файла по указанному пути.

• ::lchmod: Изменяет разрешения последней символической ссылки в заданном пути.

• ::lchown: Изменяет владельца последней символической ссылки в заданном пути.

• ::lutime: Для каждого заданного пути файла устанавливает время доступа и изменения последней символической ссылки в этом пути.

• ::rename: Перемещает файл по одному заданному пути в другой.

• ::utime: Устанавливает время доступа и изменения каждого файла по заданным путям.

• flock: Блокирует или разблокирует self.

Прочие

• ::truncate: Обрезает файл по указанному пути до заданного размера.

• ::unlink (алиас ::delete): Удаляет файлы по заданным путям.

• truncate: Обрезает self до заданного размера.