modul File::Constants

Modul File::Constants definiert dateibezogene Konstanten.

Es gibt zwei Familien von Konstanten hier

Diejenigen, die sich mit Dateizugriff befassen.
Diejenigen, die sich mit Dateinamensmusterabgleich befassen.

Dateikonstanten, die für den lokalen Prozess definiert sind, können mit der Methode File::Constants.constants abgerufen werden

File::Constants.constants.take(5)
# => [:RDONLY, :WRONLY, :RDWR, :APPEND, :CREAT]

Dateizugriff

Dateizugriffskonstanten können mit dem optionalen Argument mode in Aufrufen der folgenden Methoden verwendet werden

Lese-/Schreibzugriff

Lese-/Schreibzugriff für einen Stream kann durch eine Dateizugriffskonstante angegeben werden.

Die Konstante kann als Teil eines bitweisen OR anderer solcher Konstanten angegeben werden.

Jede Kombination der Konstanten in diesem Abschnitt kann angegeben werden.

File::RDONLY

Flagge File::RDONLY gibt an, dass der Stream nur zum Lesen geöffnet werden soll

filepath = '/tmp/t.tmp'
f = File.new(filepath, File::RDONLY)
f.write('Foo') # Raises IOError (not opened for writing).

File::WRONLY

Flagge File::WRONLY gibt an, dass der Stream nur zum Schreiben geöffnet werden soll

f = File.new(filepath, File::WRONLY)
f.read # Raises IOError (not opened for reading).

File::RDWR

Flagge File::RDWR gibt an, dass der Stream sowohl zum Lesen als auch zum Schreiben geöffnet werden soll

f = File.new(filepath, File::RDWR)
f.write('Foo') # => 3
f.rewind       # => 0
f.read         # => "Foo"

Dateipositionierung

File::APPEND

Flagge File::APPEND gibt an, dass der Stream im Anhängemodus geöffnet werden soll.

Vor jeder Schreiboperation wird die Position auf das Ende des Streams gesetzt. Die Änderung der Position und die nachfolgende Schreiboperation werden als einzelner atomarer Schritt ausgeführt.

Flagge File::TRUNC gibt an, dass der Stream am Anfang gekürzt werden soll. Wenn die Datei existiert und erfolgreich zum Schreiben geöffnet wurde, wird sie auf Position Null gekürzt; ihre ctime und mtime werden aktualisiert.

Es hat keine Auswirkung auf eine FIFO-Spezialdatei oder ein Terminalgerät. Die Auswirkung auf andere Dateitypen ist implementierungsabhängig. Das Ergebnis der Verwendung von File::TRUNC mit File::RDONLY ist undefiniert.

Erstellen und Beibehalten

File::CREAT

Flagge File::CREAT gibt an, dass der Stream erstellt werden soll, wenn er noch nicht existiert.

Wenn die Datei existiert

- Raise an exception if File::EXCL is also specified.
- Otherwise, do nothing.

Wenn die Datei nicht existiert, wird sie erstellt. Bei erfolgreichem Abschluss werden atime, ctime und mtime der Datei aktualisiert, und ctime und mtime des übergeordneten Verzeichnisses werden aktualisiert.

File::EXCL

Flagge File::EXCL gibt an, dass der Stream noch nicht existieren darf; Wenn die Flags File::CREAT und File::EXCL beide angegeben sind und der Stream bereits existiert, wird eine Ausnahme ausgelöst.

Die Prüfung auf Existenz und Erstellung der Datei wird als atomarer Vorgang durchgeführt.

Wenn sowohl File::EXCL als auch File::CREAT angegeben sind und der Pfad auf einen symbolischen Link zeigt, wird unabhängig vom Inhalt des symbolischen Links eine Ausnahme ausgelöst.

Wenn File::EXCL angegeben ist und File::CREAT nicht angegeben ist, ist das Ergebnis undefiniert.

POSIX-Dateikonstanten

Einige Dateizugriffskonstanten sind nur auf POSIX-konformen Systemen definiert; diese sind

File::SYNC.
File::DSYNC.
File::RSYNC.
File::DIRECT.
File::NOATIME.
File::NOCTTY.
File::NOFOLLOW.
File::TMPFILE.

File::SYNC, File::RSYNC und File::DSYNC

Flagge File::SYNC, File::RSYNC oder File::DSYNC gibt die Synchronisierung von E/A-Operationen mit dem zugrunde liegenden Dateisystem an.

Diese Flags sind nur für POSIX-konforme Systeme gültig.

File::SYNC gibt an, dass alle Schreibvorgänge (sowohl Daten als auch Metadaten) sofort auf das zugrunde liegende Speichergerät geleert werden. Das bedeutet, dass die Daten auf das Speichergerät geschrieben werden und die Metadaten der Datei (z. B. Dateigröße, Zeitstempel, Berechtigungen) ebenfalls synchronisiert werden. Dies garantiert, dass die Daten sicher auf dem Speichermedium gespeichert werden, bevor die Kontrolle an das aufrufende Programm zurückgegeben wird. Dieses Flag kann erhebliche Auswirkungen auf die Leistung haben, da es synchrone Schreibvorgänge erfordert, die langsamer sein können als asynchrone Schreibvorgänge.
File::RSYNC gibt an, dass Lesevorgänge auf der Datei nicht zurückgegeben werden, bis alle ausstehenden Schreibvorgänge (die ausgegeben, aber noch nicht abgeschlossen wurden) ebenfalls synchronisiert sind. Dies ist nützlich, wenn Sie die aktuellsten Daten lesen möchten, die möglicherweise noch im Prozess des Schreibens sind.
File::DSYNC gibt an, dass alle Daten-Schreibvorgänge sofort auf das zugrunde liegende Speichergerät geleert werden; dies unterscheidet sich von File::SYNC, das erfordert, dass auch Metadaten synchronisiert werden.

Beachten Sie, dass das Verhalten dieser Flags je nach Betriebssystem und Dateisystem leicht variieren kann. Darüber hinaus können die Verwendung dieser Flags aufgrund der synchronen Natur der E/A-Vorgänge Auswirkungen auf die Leistung haben, daher sollten sie mit Bedacht eingesetzt werden, insbesondere in leistungskritischen Anwendungen.

File::NOCTTY

Flagge File::NOCTTY gibt an, dass das Gerät, wenn es sich um ein Terminalgerät handelt, nicht zum steuernden Terminal des Prozesses wird.