<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>stream_get_meta_data</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Stream Functions"
HREF="ref.stream.html"><LINK
REL="PREVIOUS"
TITLE="stream_get_line"
HREF="function.stream-get-line.html"><LINK
REL="NEXT"
TITLE="stream_get_transports"
HREF="function.stream-get-transports.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.stream-get-line.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.stream-get-transports.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.stream-get-meta-data"
></A
>stream_get_meta_data</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN223293"
></A
><P
> (PHP 4 >= 4.3.0, PHP 5)</P
>stream_get_meta_data -- 从封装协议文件指针中取得报头／元数据</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN223296"
></A
><H2
>说明</H2
>array <B
CLASS="methodname"
>stream_get_meta_data</B
> ( int fp )<BR
></BR
><P
> 返回现有 <CODE
CLASS="parameter"
>stream</CODE
> 的信息。可以是任何通过
<A
HREF="function.fopen.html"
><B
CLASS="function"
>fopen()</B
></A
>，<A
HREF="function.fsockopen.html"
><B
CLASS="function"
>fsockopen()</B
></A
>
和 <A
HREF="function.pfsockopen.html"
><B
CLASS="function"
>pfsockopen()</B
></A
> 建立的流。返回的数组包含以下项目：
</P
><P
></P
><UL
><LI
><P
> <CODE
CLASS="parameter"
>timed_out</CODE
> (bool) - 如果在上次调用
<A
HREF="function.fread.html"
><B
CLASS="function"
>fread()</B
></A
> 或者 <A
HREF="function.fgets.html"
><B
CLASS="function"
>fgets()</B
></A
>
中等待数据时流超时了则为 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>blocked</CODE
> (bool) - 如果流处于阻塞
IO 模式时为 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>。参见 <A
HREF="function.stream-set-blocking.html"
><B
CLASS="function"
>stream_set_blocking()</B
></A
>。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>eof</CODE
> (bool) - 如果流到达文件末尾时为
<TT
CLASS="constant"
><B
>TRUE</B
></TT
>。注意对于 socket 流甚至当 <CODE
CLASS="parameter"
>unread_bytes</CODE
>
为非零值时也可以为 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>。要测定是否有更多数据可读，用
<A
HREF="function.feof.html"
><B
CLASS="function"
>feof()</B
></A
> 替代读取本项目的值。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>unread_bytes</CODE
> (int) - 当前在 PHP 自己的内部缓冲区中的字节数。
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
不要在脚本中使用此值。
</P
></BLOCKQUOTE
></DIV
></LI
></UL
><P
> 以下项目是 PHP 4.3 新加的：
</P
><P
></P
><UL
><LI
><P
> <CODE
CLASS="parameter"
>stream_type</CODE
> (string) - 一个描述流底层实现的标注。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>wrapper_type</CODE
> (string) -
一个描述流的分层协议封装实现的标注。更多关于封装协议的信息见
<A
HREF="wrappers.html"
>附录 N</A
>。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>wrapper_data</CODE
> (mixed) -
当前流附加的封装协议数据。更多封装协议及其数据的信息见
<A
HREF="wrappers.html"
>附录 N</A
>。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>filters</CODE
> (array) -
包含有被叠加在当前流的任何过滤器名的数组。过滤器的文档见附录中的<A
HREF="filters.html"
>可用过滤器列表</A
>。
</P
></LI
></UL
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
本函数是 PHP 4.3 引进的，在此版本之前，可以用 <A
HREF="function.socket-get-status.html"
><B
CLASS="function"
>socket_get_status()</B
></A
>
来取得前四个项目并且<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>仅能用于基于 socket 的流</I
></SPAN
>。
</P
><P
> 在 PHP 4.3 及以后版本中，<A
HREF="function.socket-get-status.html"
><B
CLASS="function"
>socket_get_status()</B
></A
>
是本函数的别名。
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
本函数不能作用于通过 <A
HREF="ref.sockets.html"
>Socket 扩展库</A
>创建的流。
</P
></BLOCKQUOTE
></DIV
><P
> 以下项目为 PHP 5.0 新加：
</P
><P
></P
><UL
><LI
><P
> <CODE
CLASS="parameter"
>mode</CODE
> (string) - 对当前流所要求的访问类型（见
<A
HREF="function.fopen.html"
>fopen()</A
> 中的表格 1）。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>seekable</CODE
> (bool) - 是否可以在当前流中定位。
</P
></LI
><LI
><P
> <CODE
CLASS="parameter"
>uri</CODE
> (string) - 与当前流关联的 URI 或文件名。
</P
></LI
></UL
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.stream-get-line.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.stream-get-transports.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>stream_get_line</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.stream.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>stream_get_transports</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
