Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969381817 php.internals:48258
Return-Path: <petercowburn@gmail.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 39289 invoked from network); 11 May 2010 12:40:43 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 11 May 2010 12:40:43 -0000
Authentication-Results: pb1.pair.com header.from=petercowburn@gmail.com; sender-id=pass; domainkeys=bad
Authentication-Results: pb1.pair.com smtp.mail=petercowburn@gmail.com; spf=pass; sender-id=pass
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.221.179 as permitted sender)
DomainKey-Status: bad
X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01
X-PHP-List-Original-Sender: petercowburn@gmail.com
X-Host-Fingerprint: 209.85.221.179 mail-qy0-f179.google.com  
Received: from [209.85.221.179] ([209.85.221.179:64627] helo=mail-qy0-f179.google.com)
	by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP
	id 3E/AE-63992-A4059EB4 for <phpdoc@lists.php.net>; Tue, 11 May 2010 08:40:42 -0400
Received: by qyk9 with SMTP id 9so7562918qyk.2
        for <multiple recipients>; Tue, 11 May 2010 05:40:39 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:received:in-reply-to
         :references:date:message-id:subject:from:to:cc:content-type
         :content-transfer-encoding;
        bh=eFfTPYQq7byE0Aw2VTCPRer1eavEWESb/JSDw8pKXRg=;
        b=sItfMeJNxNdhg3Hg4Sqdd5zg2XELlNKYVawrdaZuJvjjWFrkspsTFbheLqvU6xPOZs
         VVAeC/pnhNUHQ73c1QA9TsyWCywVZG4/kWmV0Y7id+6f5xPgPaEGlZnlh2tl3CbxXVZU
         fWhu4GWo+A3D8MwTQU+d7jmduLi7gT73qKIdg=
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:content-transfer-encoding;
        b=NQT0nDqrBC6AqpIym5HEiB5IYbnpTR9PtECQUKzG3PkGZ3v1PxVadU+LdbLFOz2Qu8
         7RdTkX04fTMy9+2DXCc9wfG4WAitT6pZyqanoG1QCdrj+/iyXvNh8DXO5UqjVn5pZoKC
         jzvzsFCkhp0iVL7t9NwM5PKC8lRUCK6qfOlAM=
MIME-Version: 1.0
Received: by 10.224.53.91 with SMTP id l27mr3658876qag.352.1273581632307; Tue, 
	11 May 2010 05:40:32 -0700 (PDT)
Received: by 10.224.46.8 with HTTP; Tue, 11 May 2010 05:40:32 -0700 (PDT)
In-Reply-To: <AANLkTikAoLN2UWonXhXjbCsTj_2f0yXW7U0v3Zbf2Tr8@mail.gmail.com>
References: <w2v10845a341005050925z64c7394epe5cd195478395619@mail.gmail.com>
	 <o2nd3ada2bf1005060055jc8fb8fe6zc8315e059cf716ea@mail.gmail.com>
	 <AANLkTikAoLN2UWonXhXjbCsTj_2f0yXW7U0v3Zbf2Tr8@mail.gmail.com>
Date: Tue, 11 May 2010 13:40:32 +0100
Message-ID: <AANLkTimnVuM65HteRsyX54JwjMM6G_w2ZQCKC4zpnPXu@mail.gmail.com>
To: RQuadling <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
Content-Transfer-Encoding: quoted-printable
Subject: Re: [PHP-DOC] What is the use of the $replacement property in the 
	RegexIterator class.
From: petercowburn@gmail.com (Peter Cowburn)

On 11 May 2010 13:33:46 UTC+1, Richard Quadling
<rquadling@googlemail.com> wrote:
> On 6 May 2010 08:55, Peter Cowburn <petercowburn@gmail.com> wrote:
>> 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"]=3D>NULL
>>>
>>> Assigning a value to $replacement seems to have no bearing on the outpu=
t.
>>
>> 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. =A0There 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/regexiterat=
or.inc?view=3Dmarkup
>> ).
>>
>>>
>>> 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=3DZEND002498&r=3D21=
3474731
>>> ZOPA : http://uk.zopa.com/member/RQuadling
>>>
>>
>
> So, this should be documented as what?
>
> As we don't document the future, I think this property should be
> omitted from the RegexIterator documentation until such time the
> property is useful.
>
> Basically, leave it as is.

Sounds fine to me.

>
> Yes?
>
> --
> -----
> 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=3DZEND002498&r=3D2134=
74731
> ZOPA : http://uk.zopa.com/member/RQuadling
>