stream_get_meta_data

說明

返回現(xiàn)有 stream 的信息?？梢允侨魏瓮ㄟ^ fopen()，fsockopen() 和 pfsockopen() 建立的流。返回的數(shù)組包含以下項目：

• timed_out (bool) - 如果在上次調(diào)用 fread() 或者 fgets() 中等待數(shù)據(jù)時流超時了則為 true。

• blocked (bool) - 如果流處于阻塞 IO 模式時為 true。參見 stream_set_blocking()。

• eof (bool) - 如果流到達文件末尾時為 true。注意對于 socket 流甚至當(dāng) unread_bytes 為非零值時也可以為 true。要測定是否有更多數(shù)據(jù)可讀，用 feof() 替代讀取本項目的值。

• unread_bytes (int) - 當(dāng)前在 PHP 自己的內(nèi)部緩沖區(qū)中的字節(jié)數(shù)。

  注意: 不要在腳本中使用此值。

以下項目是 PHP 4.3 新加的：

• stream_type (string) - 一個描述流底層實現(xiàn)的標(biāo)注。

• wrapper_type (string) - 一個描述流的分層協(xié)議封裝實現(xiàn)的標(biāo)注。更多關(guān)于封裝協(xié)議的信息見 支持的協(xié)議和封裝協(xié)議。

• wrapper_data (mixed) - 當(dāng)前流附加的封裝協(xié)議數(shù)據(jù)。更多封裝協(xié)議及其數(shù)據(jù)的信息見 支持的協(xié)議和封裝協(xié)議。

• filters (array) - 包含有被疊加在當(dāng)前流的任何過濾器名的數(shù)組。過濾器的文檔見附錄中的可用過濾器列表。

注意:

本函數(shù)是 PHP 4.3 引進的，在此版本之前，可以用 socket_get_status() 來取得前四個項目并且僅能用于基于 socket 的流。

在 PHP 4.3 及以后版本中，socket_get_status() 是本函數(shù)的別名。

注意: 本函數(shù)不能作用于通過 Socket 擴展庫創(chuàng)建的流。

以下項目為 PHP 5.0 新加：

• mode (string) - 對當(dāng)前流所要求的訪問類型（見 fopen() 中的表格 1）。

• seekable (bool) - 是否可以在當(dāng)前流中定位。

• uri (string) - 與當(dāng)前流關(guān)聯(lián)的 URI 或文件名。