Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969381801 php.internals:48227
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.223.201 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type;
        b=Dj/UFEtUrxVsDpIq38oy0KMdOB5jpG1/Ky0xxbHfyhVzWyFzkXrWHgJqyLjMOH3Und
         wcqRwsTKCOna3abOjcnqwNwR4Q8BMglFTdHvWDGMhQWo3ErfpQABmZrgtWtvG1pGO9nD
         49muqWJE04ZkgLGrJgLFUMgvMmjwiZpTXyIBU=
MIME-Version: 1.0
In-Reply-To: <w2v10845a341005050925z64c7394epe5cd195478395619@mail.gmail.com>
References: <w2v10845a341005050925z64c7394epe5cd195478395619@mail.gmail.com>
Date: Thu, 6 May 2010 08:55:34 +0100
Message-ID: <o2nd3ada2bf1005060055jc8fb8fe6zc8315e059cf716ea@mail.gmail.com>
To: RQuadling@googlemail.com
Cc: PHP internals <internals@lists.php.net>, PHP Documentation List <phpdoc@lists.php.net>, 
	=?ISO-8859-1?Q?Marcus_B=F6rger?= <helly@php.net>, 
	Etienne Kneuss <colder@php.net>
Content-Type: text/plain; charset=ISO-8859-1
Subject: Re: [PHP-DOC] What is the use of the $replacement property in the 
	RegexIterator class.
From: petercowburn@gmail.com (Peter Cowburn)

On 5 May 2010 17:25, Richard Quadling <rquadling@googlemail.com> wrote:
> Hi.
>
> I'm in the process of getting the PHPDoc classes showing the correct
> inherited properties and methods (public/protected but not private).
>
> I picked RecursiveRegexIterator (it has the largest number of
> xi:includes in the documentation) as a test.
>
> Using php --rc I see that the inheritance chain is
> RecursiveRegexIterator, RegexIterator, FilterIterator and
> IteratorIterator.
>
> The property $replacement is part of RegexIterator.
>
> I can see no documentation for this in phpdoc, nor in the Doxygen at
> http://www.php.net/~helly/php/ext/spl/
>
>
> In all the examples I've made so far, var_dump()-ing the RegexIterator
> results in a ["replacement"]=>NULL
>
> Assigning a value to $replacement seems to have no bearing on the output.

I believe the intention was to give that property a value which could
be used with RegexIterator::REPLACE mode but that particular mode has
not yet been fully implemented.  There is a related bug (
http://bugs.php.net/50579 ) that has not been assigned; I can't say
what the plan is for if/when the replacement mode will get some
attention. See also: the PHP implementation of RegexIterator (
http://svn.php.net/viewvc/php/php-src/trunk/ext/spl/internal/regexiterator.inc?view=markup
).

>
> Regards,
>
> Richard.
>
>
> --
> -----
> Richard Quadling
> "Standing on the shoulders of some very clever giants!"
> EE : http://www.experts-exchange.com/M_248814.html
> EE4Free : http://www.experts-exchange.com/becomeAnExpert.jsp
> Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
> ZOPA : http://uk.zopa.com/member/RQuadling
>