<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Duplicating Variable Contents: The Copy Constructor</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Zend API：深入 PHP 内核"
HREF="zend.html"><LINK
REL="PREVIOUS"
TITLE="Creating Variables"
HREF="zend.variables.html"><LINK
REL="NEXT"
TITLE="Returning Values"
HREF="zend.returning.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="sect1"
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="zend.variables.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>章 46. Zend API：深入 PHP 内核</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="zend.returning.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="zend.copy-constructor"
>Duplicating Variable Contents: The Copy Constructor</A
></H1
><P
> Sooner or later, you may need to assign the contents of one
<CODE
CLASS="envar"
>zval</CODE
> container to another. This is easier said than
done, since the <CODE
CLASS="envar"
>zval</CODE
> container doesn't contain only
type information, but also references to places in Zend's internal
data. For example, depending on their size, arrays and objects may
be nested with lots of hash table entries. By assigning one
<CODE
CLASS="envar"
>zval</CODE
> to another, you avoid duplicating the hash
table entries, using only a reference to them (at most).
</P
><P
> To copy this complex kind of data, use the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>copy
constructor</I
></SPAN
>. Copy constructors are typically defined in
languages that support operator overloading, with the express
purpose of copying complex types. If you define an object in such a
language, you have the possibility of overloading the "=" operator,
which is usually responsible for assigning the contents of the
rvalue (result of the evaluation of the right side of the operator)
to the lvalue (same for the left side).
</P
><P
> <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Overloading</I
></SPAN
> means assigning a different
meaning to this operator, and is usually used to assign a function
call to an operator. Whenever this operator would be used on such
an object in a program, this function would be called with the
lvalue and rvalue as parameters. Equipped with that information, it
can perform the operation it intends the "=" operator to have
(usually an extended form of copying).
</P
><P
> This same form of "extended copying" is also necessary for PHP's
<CODE
CLASS="envar"
>zval</CODE
> containers. Again, in the case of an array,
this extended copying would imply re-creation of all hash table
entries relating to this array. For strings, proper memory
allocation would have to be assured, and so on.
</P
><P
> Zend ships with such a function,
called <B
CLASS="function"
>zend_copy_ctor()</B
> (the previous PHP equivalent
was <B
CLASS="function"
>pval_copy_constructor()</B
>).
</P
><P
> A most useful demonstration is a function that accepts a complex type as
argument, modifies it, and then returns the argument:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="programlisting"
>zval *parameter;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &parameter) == FAILURE)
return;
}
// do modifications to the parameter here
// now we want to return the modified container:
*return_value = *parameter;
zval_copy_ctor(return_value);</PRE
></TD
></TR
></TABLE
><P
> The first part of the function is plain-vanilla argument retrieval.
After the (left out) modifications, however, it gets interesting:
The container of <CODE
CLASS="envar"
>parameter</CODE
> is assigned to the
(predefined) <CODE
CLASS="envar"
>return_value</CODE
> container. Now, in order
to effectively duplicate its contents, the copy constructor is
called. The copy constructor works directly with the supplied
argument, and the standard return values are
<TT
CLASS="literal"
>FAILURE</TT
> on failure and
<TT
CLASS="literal"
>SUCCESS</TT
> on success.
</P
><P
> If you omit the call to the copy constructor in this example, both
<CODE
CLASS="envar"
>parameter</CODE
> and <CODE
CLASS="envar"
>return_value</CODE
> would
point to the same internal data, meaning that
<CODE
CLASS="envar"
>return_value</CODE
> would be an illegal additional
reference to the same data structures. Whenever changes occurred in
the data that <CODE
CLASS="envar"
>parameter</CODE
> points to,
<CODE
CLASS="envar"
>return_value</CODE
> might be affected. Thus, in order to
create separate copies, the copy constructor must be used.
</P
><P
> The copy constructor's counterpart in the Zend API, the destructor
<B
CLASS="function"
>zval_dtor()</B
>, does the opposite of the
constructor.
</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="zend.variables.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="zend.returning.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Creating Variables</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="zend.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Returning Values</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
