<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>hw_api->object</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Hyperwave API Functions"
HREF="ref.hwapi.html"><LINK
REL="PREVIOUS"
TITLE="hw_api_object->value"
HREF="function.hwapi-object-value.html"><LINK
REL="NEXT"
TITLE="hw_api->objectbyanchor"
HREF="function.hwapi-objectbyanchor.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.hwapi-object-value.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.hwapi-objectbyanchor.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.hwapi-object"
></A
>hw_api->object</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN78682"
></A
><P
> (no version information, might be only in CVS)</P
>hw_api->object -- Retrieve attribute information</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN78685"
></A
><H2
>Description</H2
>hw_api_object <B
CLASS="methodname"
>hw_api->object</B
> ( array parameter )<BR
></BR
><P
> This function retrieves the attribute information of an object of any
version. It will not return the document content. The parameter array
contains the required elements 'objectIdentifier' and the optional
elements 'attributeSelector' and 'version'.
</P
><P
> The returned object is an instance of class
<B
CLASS="classname"
>HW_API_Object</B
> on success or
<B
CLASS="classname"
>HW_API_Error</B
> if an error occurred.
</P
><P
> This simple example retrieves an object and checks for errors.
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN78698"
></A
><P
><B
>例 1. Retrieve an object</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#007700">function </font><font color="#0000BB">handle_error</font><font color="#007700">(</font><font color="#0000BB">$error</font><font color="#007700">) <br />{<br /> </font><font color="#0000BB">$reason </font><font color="#007700">= </font><font color="#0000BB">$error</font><font color="#007700">-></font><font color="#0000BB">reason</font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">);<br /> echo </font><font color="#DD0000">"Type: <b>"</font><font color="#007700">;<br /> switch (</font><font color="#0000BB">$reason</font><font color="#007700">-></font><font color="#0000BB">type</font><font color="#007700">()) {<br /> case </font><font color="#0000BB">0</font><font color="#007700">:<br /> echo </font><font color="#DD0000">"Error"</font><font color="#007700">;<br /> break;<br /> case </font><font color="#0000BB">1</font><font color="#007700">:<br /> echo </font><font color="#DD0000">"Warning"</font><font color="#007700">;<br /> break;<br /> case </font><font color="#0000BB">2</font><font color="#007700">:<br /> echo </font><font color="#DD0000">"Message"</font><font color="#007700">;<br /> break;<br /> }<br /> echo </font><font color="#DD0000">"</b><br />\n"</font><font color="#007700">;<br /> echo </font><font color="#DD0000">"Description: " </font><font color="#007700">. </font><font color="#0000BB">$reason</font><font color="#007700">-></font><font color="#0000BB">description</font><font color="#007700">(</font><font color="#DD0000">"en"</font><font color="#007700">) . </font><font color="#DD0000">"<br />\n"</font><font color="#007700">;<br />}<br /><br />function </font><font color="#0000BB">list_attr</font><font color="#007700">(</font><font color="#0000BB">$obj</font><font color="#007700">) <br />{<br /> echo </font><font color="#DD0000">"<table>\n"</font><font color="#007700">;<br /> </font><font color="#0000BB">$count </font><font color="#007700">= </font><font color="#0000BB">$obj</font><font color="#007700">-></font><font color="#0000BB">count</font><font color="#007700">();<br /> for (</font><font color="#0000BB">$i</font><font color="#007700">=</font><font color="#0000BB">0</font><font color="#007700">; </font><font color="#0000BB">$i</font><font color="#007700"><</font><font color="#0000BB">$count</font><font color="#007700">; </font><font color="#0000BB">$i</font><font color="#007700">++) {<br /> </font><font color="#0000BB">$attr </font><font color="#007700">= </font><font color="#0000BB">$obj</font><font color="#007700">-></font><font color="#0000BB">attribute</font><font color="#007700">(</font><font color="#0000BB">$i</font><font color="#007700">);<br /> </font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"<tr><td align=\"right\" bgcolor=\"#c0c0c0\"><b>%s</b></td><td bgcolor=\"#F0F0F0\">%s</td></tr>\n"</font><font color="#007700">,<br /> </font><font color="#0000BB">$attr</font><font color="#007700">-></font><font color="#0000BB">key</font><font color="#007700">(), </font><font color="#0000BB">$attr</font><font color="#007700">-></font><font color="#0000BB">value</font><font color="#007700">());<br /> }<br /> echo </font><font color="#DD0000">"</table>\n"</font><font color="#007700">;<br />}<br /><br /></font><font color="#0000BB">$hwapi </font><font color="#007700">= </font><font color="#0000BB">hwapi_hgcsp</font><font color="#007700">(</font><font color="#0000BB">$g_config</font><font color="#007700">[</font><font color="#0000BB">HOSTNAME</font><font color="#007700">]);<br /></font><font color="#0000BB">$parms </font><font color="#007700">= array(</font><font color="#DD0000">"objectIdentifier"</font><font color="#007700">=></font><font color="#DD0000">"rootcollection"</font><font color="#007700">, </font><font color="#DD0000">"attributeSelector"</font><font color="#007700">=>array(</font><font color="#DD0000">"Title"</font><font color="#007700">, </font><font color="#DD0000">"Name"</font><font color="#007700">, </font><font color="#DD0000">"DocumentType"</font><font color="#007700">));<br /></font><font color="#0000BB">$root </font><font color="#007700">= </font><font color="#0000BB">$hwapi</font><font color="#007700">-></font><font color="#0000BB">object</font><font color="#007700">(</font><font color="#0000BB">$parms</font><font color="#007700">);<br />if (</font><font color="#0000BB">get_class</font><font color="#007700">(</font><font color="#0000BB">$root</font><font color="#007700">) == </font><font color="#DD0000">"HW_API_Error"</font><font color="#007700">) {<br /> </font><font color="#0000BB">handle_error</font><font color="#007700">(</font><font color="#0000BB">$root</font><font color="#007700">);<br /> exit;<br />}<br /></font><font color="#0000BB">list_attr</font><font color="#007700">(</font><font color="#0000BB">$root</font><font color="#007700">);<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> See also <A
HREF="function.hwapi-content.html"
><B
CLASS="function"
>hwapi_content()</B
></A
>.
</P
></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.hwapi-object-value.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.hwapi-objectbyanchor.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>hw_api_object->value</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.hwapi.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>hw_api->objectbyanchor</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
