<HTML ><HEAD ><TITLE >API Macros</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Extending PHP 4.0" HREF="zend.html"><LINK REL="PREVIOUS" TITLE="Reference: Some Configuration Macros" HREF="zend.configuration-macros.html"><LINK REL="NEXT" TITLE="Streams API for PHP Extension Authors" HREF="streams.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="chapter" 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 Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="zend.configuration-macros.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="streams.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="chapter" ><H1 ><A NAME="zend.api-macros" >Chapter 42. API Macros</A ></H1 ><P >A set of macros was introduced into Zend's API that simplify access to <TT CLASS="envar" >zval</TT > containers (see <A HREF="zend.api-macros.html#tab.api-macros" >Table 42-1</A >).</P ><DIV CLASS="table" ><A NAME="tab.api-macros" ></A ><P ><B >Table 42-1. API Macros for Accessing <TT CLASS="envar" >zval</TT > Containers</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" >Macro</TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" >Refers to</TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_LVAL(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(zval).value.lval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_DVAL(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(zval).value.dval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRVAL(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(zval).value.str.val</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRLEN(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(zval).value.str.len</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_ARRVAL(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(zval).value.ht</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_LVAL_P(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(*zval).value.lval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_DVAL_P(zval)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(*zval).value.dval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRVAL_P(zval_p)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(*zval).value.str.val</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRLEN_P(zval_p)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(*zval).value.str.len</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_ARRVAL_P(zval_p)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(*zval).value.ht</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_LVAL_PP(zval_pp)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(**zval).value.lval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_DVAL_PP(zval_pp)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(**zval).value.dval</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRVAL_PP(zval_pp)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(**zval).value.str.val</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_STRLEN_PP(zval_pp)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(**zval).value.str.len</TT ></TD ></TR ><TR ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="literal" >Z_ARRVAL_PP(zval_pp)</TT ></TD ><TD WIDTH="50%" ALIGN="LEFT" VALIGN="MIDDLE" ><TT CLASS="envar" >(**zval).value.ht</TT ></TD ></TR ></TBODY ></TABLE ></DIV ></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="zend.configuration-macros.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="streams.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Reference: Some Configuration Macros</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="zend.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Streams API for PHP Extension Authors</TD ></TR ></TABLE ></DIV ></BODY ></HTML >