This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

I only saw one error in the documentation and have fixed it. Remember that octal representation is base 8, not base 10. \36 is not the '$' character, it is ASCII character 30, which is why your expected result and all its \<digits> are wrong.

Thanks for the response.  To clarify, which statement in the
addcslashes() documentation is incorrect?

"Use the ord() function to find the ASCII value for a character."

<?php
// OK, I'll give it a shot:
print ord('$'); // prints 36
?>

OK, I agree -- the ASCII value for the dollar sign character is 36.  Now, back to the documentation...

"charlist like "\0..\37", which would escape all characters with ASCII code between 0 and 37."

Example 1. addcslashes() example

<?php
$escaped = addcslashes($not_escaped, "\0..\37!@\177..\377");
?>

<?php
// Following suit, I want to escape the dollar
// sign ($) character which has ASCII code 36,
// as just established in the previous code:
$escaped = addcslashes('$', "\36");
print $escaped; // prints $
// ...whereas...
$escaped = addcslashes('$', "\44"); // octal
print $escaped; // prints \$
?>

Conclusion:
The documentation states that characters with ASCII code lower than 32 and higher than 126 are converted to octal representation.  I can understand that.  However, as this example demonstrates, it seems the charlist parameter expects octal values, for any range, not just those characters with ASCII values < 32 or > 126.

Still confused.  Is it the second statement that is incorrect?  Does the charlist parameter always expect octal values?

Thanks -- Todd

You need to know that "\36" is the ASCII character number 30. Read http://www.php.net/manual/en/language.types.string.php#language.types.string.syntax.double

If you want to escape $, use just addcslashes($str, '$');

>>If you want to escape $, use just addcslashes($str, '$');

(Smiling) Thanks, but I was merely using that as an example.  Indeed, I know how to accomplish my goal using the function, it's the documentation that is misleading.  On the one hand the documentation is referencing ASCII number ranges, then in the follow-up example it jumps to octal representation (using the double quotations).  And yes, your reference to the documentation regarding double-quoted strings turned on the lights -- thank you.  Please understand my good intentions here, trying to make the language and documentation the best it can be.  I highly recommend an update to the addcslashes manual pages to clarify the example is using octal representation.

Sincerely,
Todd