<!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="Manual do 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" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.hwapi-object-value.html" ACCESSKEY="P" >Anterior</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" >Próxima</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="AEN74461" ></A ><P > (no version information, might be only in CVS)</P >hw_api->object -- Retrieve attribute information</DIV ><DIV CLASS="refsect1" ><A NAME="AEN74464" ></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="AEN74477" ></A ><P ><B >Exemplo 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" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.hwapi-objectbyanchor.html" ACCESSKEY="N" >Próxima</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" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >hw_api->objectbyanchor</TD ></TR ></TABLE ></DIV ></BODY ></HTML >