Spec-Zone.ru › TensorFlow 2.3

tf.io.gfile.GFile

Просмотреть исходный код на GitHub

Обертки для ввода-вывода файлов без взаимных блокировок потоков.

Просмотр псевдонимов

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительных сведений.

tf.compat.v1.gfile.GFile, tf.compat.v1.gfile.Open, tf.compat.v1.io.gfile.GFile

tf.io.gfile.GFile(
    name, mode='r'
)

Основные роли модуля tf.io.gfile:

  1. Предоставление API, близкого к объектам ввода-вывода файлов Python,
  2. Предоставление реализации, основанной на 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
)

Перемещает указатель к смещению в файле. (устаревшие аргументы)

Предупреждение: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (position). Они будут удалены в будущей версии. Инструкции по обновлению: position устарел в пользу аргумента offset.
Аргументы
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API