tf.io.gfile.GFile
| Просмотреть исходный код на GitHub |
Обертки для ввода-вывода файлов без взаимных блокировок потоков.
tf.io.gfile.GFile(
name, mode='r'
)
Основные роли модуля tf.io.gfile:
- Предоставление API, близкого к объектам ввода-вывода файлов Python,
- Предоставление реализации, основанной на API системы файлов TensorFlow C++.
API системы файлов C++ поддерживает несколько реализаций систем файлов, включая локальные файлы, Google Cloud Storage (используя префикс gs://) и HDFS (используя префикс hdfs://). TensorFlow экспортирует их как tf.io.gfile, чтобы вы могли использовать эти реализации для сохранения и загрузки контрольных точек, записи в журналы TensorBoard и доступа к обучающим данным (и другим целям). Однако, если все ваши файлы являются локальными, вы можете использовать обычный API файлов Python без каких-либо проблем.
Примечание: хотя похож на реализацию ввода-вывода Python, существуют семантические различия, чтобы сделать tf.io.gfile более эффективным для файловых систем-хранилищ. Например, файл в режиме записи будет открыт только при первом вызове записи, чтобы свести к минимуму вызовы RPC в сетевых файловых системах.
| Атрибуты | |
|---|---|
mode | Возвращает режим, в котором был открыт файл. |
name | Возвращает имя файла. |
Методы
close
close()
Закрывает FileIO. Должен вызываться для сброса WritableFile.
flush
flush()
Сбрасывает файл Writable.
Это гарантирует, что данные покинули процесс, но не гарантирует, что они были записаны на диск. Это означает, что данные переживут сбой приложения, но не обязательно сбой ОС.
next
next()
read
read(
n=-1
)
Возвращает содержимое файла в виде строки.
Начинает чтение с текущей позиции в файле.
| Аргументы | |
|---|---|
n | Читает n байтов, если n != -1. Если n = -1, читает до конца файла. |
| Возвращает | |
|---|---|
n байтов файла (или всего файла) в режиме байтов или n байтов строки, если в режиме строки (обычном). |
readline
readline()
Читает следующую строку, сохраняя \n. В конце файла возвращает ''.
readlines
readlines()
Возвращает все строки из файла в списке.
seek
seek(
offset=None, whence=0, position=None
)
Перемещает указатель к смещению в файле. (устаревшие аргументы)
| Аргументы | |
|---|---|
offset | Количество байтов относительно аргумента whence. |
whence | Допустимые значения для whence: 0: начало файла (по умолчанию) 1: относительно текущей позиции в файле 2: относительно конца файла. offset обычно отрицательное. |
seekable
seekable()
Возвращает True, так как FileIO поддерживает операции случайного доступа seek()/tell()
size
size()
Возвращает размер файла.
tell
tell()
Возвращает текущую позицию в файле.
write
write(
file_content
)
Записывает file_content в файл. Добавляет в конец файла.
__enter__
__enter__()
Делает пригодным для использования с оператором "with".
__exit__
__exit__(
unused_type, unused_value, unused_traceback
)
Делает пригодным для использования с оператором "with".
__iter__
__iter__()
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/io/gfile/GFile