[PHP-DOC] #20481 [NEW]: preg_replace_callback() incorrect documentation From: bikeman82 <email protected>
Date: 11/18/02

From: bikeman82 <email protected>
Operating system: All
PHP version: 4.2.3
PHP Bug Type: Documentation problem
Bug description: preg_replace_callback() incorrect documentation

The documentation of preg_replace_callback() states that it is functioning
exactly like preg_replace(), except for the second argument, that should
be a 'callback'.

This is the current text:
"The behavior of this function is almost identical to preg_replace(),
except for the fact that instead of replacement parameter, one should
specify a callback that will be called and passed an array of matched
elements in the subject string. The callback should return the replacement
string. This function was added in PHP 4.0.5."

I think this is way too vague, and most of all, incorrect. Though the
functionality is similar, it is not 'almost identical'. First of all, the
callback-variant of this function is (in my release, 4.2.3) not capable of
detecting multiple patterns and passing them to multiple
callback-functions. Secondly, there is the item that is discussed in the
(English) user comments in the online version of this function, namely
that when you try to call a member function of a class from within that
class, you have to pass it an Array with as first element a reference to
$this, and then, secondly the callback-function.

Actually, I am not a very experienced php-user, and normally, I would not
post this bug, but somebody in the php.doc-newsgroup encouraged me to do
so, so this is it ...

I hope I can help the huge community I try to become a member, gets a
little improved by my first cotribution to it ...

Greetz,
Bikeman 

-- 
Edit bug report at http://bugs.php.net/?id=20481&edit=1
-- 
Try a CVS snapshot:         http://bugs.php.net/fix.php?id=20481&r=trysnapshot
Fixed in CVS:               http://bugs.php.net/fix.php?id=20481&r=fixedcvs
Fixed in release:           http://bugs.php.net/fix.php?id=20481&r=alreadyfixed
Need backtrace:             http://bugs.php.net/fix.php?id=20481&r=needtrace
Try newer version:          http://bugs.php.net/fix.php?id=20481&r=oldversion
Not developer issue:        http://bugs.php.net/fix.php?id=20481&r=support
Expected behavior:          http://bugs.php.net/fix.php?id=20481&r=notwrong
Not enough info:            http://bugs.php.net/fix.php?id=20481&r=notenoughinfo
Submitted twice:            http://bugs.php.net/fix.php?id=20481&r=submittedtwice
register_globals:           http://bugs.php.net/fix.php?id=20481&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=20481&r=php3
Daylight Savings:           http://bugs.php.net/fix.php?id=20481&r=dst
IIS Stability:              http://bugs.php.net/fix.php?id=20481&r=isapi

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php