TensorFlow函數(shù)：tf.WholeFileReader

tf.WholeFileReader函數(shù)

WholeFileReader類

繼承自：ReaderBase

定義在：tensorflow/python/ops/io_ops.py.

請參閱指南：輸入和讀取器>讀取器

將文件的全部內(nèi)容作為值輸出的Reader.

如果要使用,請在隊列(Queue)中的排列文件名.Read的輸出將是一個文件名(key)和該文件的內(nèi)容(value).

有關(guān)支持的方法,請參閱ReaderBase.

Eager兼容性

讀者與eager的執(zhí)行不兼容.相反的,你需要使用tf.data將數(shù)據(jù)存入您的模型.

屬性

• reader_ref
  實現(xiàn)了讀取器的操作.
  
• supports_serialize
  表示Reader實現(xiàn)是否可以序列化其狀態(tài).
  

方法

__init__

__init__(name=None)

該方法用于創(chuàng)建一個WholeFileReader.

參數(shù)：

• name：操作的名稱(可選).

num_records_produced

num_records_produced(name=None)

返回此讀取器生成的記錄數(shù).

這與已成功讀取執(zhí)行的次數(shù)相同.

參數(shù)：

• name：操作的名稱(可選).

返回值：

該方法返回一個類型為int64的張量.

num_work_units_completed

num_work_units_completed(name=None)

返回此讀取器完成處理的工作單位數(shù).

參數(shù)：

• name：操作的名稱(可選).

返回值：

該函數(shù)返回一個類型為int64的張量.

read

read(
    queue,
    name=None
)

返回讀取器生成的下一條記錄(key,value)對.

如果需要,將從隊列中取出一個工作單元(例如,當(dāng)Reader需要從一個新文件開始讀取,因為它已經(jīng)完成了前一個文件).

參數(shù)：

• queue：隊列或可變字符串張量,表示隊列的句柄,包含字符串工作項.
• name：操作的名稱(可選).

返回值：

張量元組(key,value),其中,key是一個字符串標(biāo)量張量,value是一個字符串標(biāo)量張量.

read_up_to

read_up_to(
    queue,
    num_records,
    name=None
)

最多返回由讀取器生成的num_records(key,value)對.

如果需要,將從隊列中取出一個工作單元(例如,Reader需要從一個新文件開始讀取,因為它已經(jīng)完成了前一個文件).即使在最后一批之前,它的返回率也可能少于num_records.

參數(shù)：

• queue：隊列或可變字符串張量,表示隊列的句柄,包含字符串工作項.
• num_records：要讀取的記錄數(shù).
• name：操作的名稱(可選).

返回值：

張量元組(keys,values),其中,keys是一維字符串張量,values也是一維字符串張量.

reset

reset(name=None)

將讀取器恢復(fù)到其初始狀態(tài).

參數(shù)：

• name：操作的名稱(可選).

返回值：

該方法返回創(chuàng)建的操作.

restore_state

restore_state(
    state,
    name=None
)

將讀取器恢復(fù)到先前保存的狀態(tài).

并非所有讀取器都能夠支持restore,所以這可能會產(chǎn)生未實現(xiàn)的錯誤.

參數(shù)：

• state：一個字符串張量,具有匹配類型的Reader的SerializeState的結(jié)果.
• name：操作的名稱(可選).

返回值：

該方法返回創(chuàng)建的操作.

serialize_state

serialize_state(name=None)

生成一個字符串張量,用于編碼讀取器的狀態(tài).

并非所有的讀取器都支持序列化,所以這可能會產(chǎn)生未實現(xiàn)的錯誤.

參數(shù)：

• name：操作的名稱(可選).

返回值：

該方法返回一個字符串張量.