[DOC-CVS] [doc-en] master: filter/constants.xml Fix typo, add a description (#4854)
[email protected] (Mikhail Alferov via GitHub)
| Newsgroups | php.doc.cvs |
|---|---|
| Message-ID | <[email protected]> |
Author: Mikhail Alferov (mmalferov)
Committer: GitHub (web-flow)
Pusher: Crell
Date: 2025-10-03T10:11:19-05:00
Commit: https://github.com/php/doc-en/commit/9b09581bfdd1fa1c33daa740ad49599cf665cff4
Raw diff: https://github.com/php/doc-en/commit/9b09581bfdd1fa1c33daa740ad49599cf665cff4.diff
filter/constants.xml Fix typo, add a description (#4854)
Changed paths:
M reference/filter/constants.xml
Diff:
diff --git a/reference/filter/constants.xml b/reference/filter/constants.xml
index 18f42ee48425..2ff05f6bd932 100644
--- a/reference/filter/constants.xml
+++ b/reference/filter/constants.xml
@@ -135,7 +135,7 @@
</term>
<listitem>
<simpara>
- This flags wraps scalar inputs into a one element <type>array</type>
+ This flag wraps scalar inputs into a one element <type>array</type>
for filters which operate on arrays.
</simpara>
</listitem>
@@ -264,18 +264,21 @@
<listitem>
<simpara>
Returns &true; for <literal>"1"</literal>,
- <literal>"true"</literal>,
+ <literal>1</literal> including binary, octal and hexadecimal notations, <literal>1.0</literal>,
+ <literal>"true"</literal>, <literal>true</literal>,
<literal>"on"</literal>,
and <literal>"yes"</literal>.
</simpara>
<simpara>
Returns &false; for <literal>"0"</literal>,
- <literal>"false"</literal>,
+ <literal>0</literal> including binary, octal and hexadecimal notations, <literal>0.0</literal>,
+ <literal>"false"</literal>, <literal>false</literal>,
<literal>"off"</literal>,
<literal>"no"</literal>, and
<literal>""</literal>.
</simpara>
<simpara>
+ String values are compared case-insensitively.
The return value for non-boolean values depends on the
<constant>FILTER_NULL_ON_FAILURE</constant>.
If it is set, &null; is returned, otherwise &false; is returned.
@@ -499,7 +502,7 @@
</term>
<listitem>
<simpara>
- Validates whether the <acronym>URL</acronym> name is valid according to
+ Validates whether the <acronym>URL</acronym> is valid according to
<link xlink:href="&url.rfc;2396">RFC 2396</link>.
</simpara>
<variablelist xml:id="filter.constants.validation.url.options">
@@ -949,6 +952,9 @@
<member><literal>&</literal></member>
</simplelist>
and characters with an ASCII value less than 32.
+ Unlike the <constant>FILTER_SANITIZE_FULL_SPECIAL_CHARS</constant> filter, the
+ <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant> filter ignores the
+ <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> flag.
</para>
<simpara>
Optionally it can strip specified characters if used together with