<!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 >