[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/_language-snippets.ent_reference/filesystem/functions/pars
From:       Maciej_Sobaczewski <sobak () php ! net>
Date:       2015-06-16 5:05:37
Message-ID: svn-sobak-1434431137-336975-752158512 () svn ! php ! net
[Download RAW message or body]

sobak                                    Tue, 16 Jun 2015 05:05:37 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=336975

Log:
Document INI_SCANNER_TYPED

Changed paths:
    U   phpdoc/en/trunk/language-snippets.ent
    U   phpdoc/en/trunk/reference/filesystem/functions/parse-ini-file.xml
    U   phpdoc/en/trunk/reference/filesystem/functions/parse-ini-string.xml

Modified: phpdoc/en/trunk/language-snippets.ent
===================================================================
--- phpdoc/en/trunk/language-snippets.ent	2015-06-15 22:13:49 UTC (rev 336974)
+++ phpdoc/en/trunk/language-snippets.ent	2015-06-16 05:05:37 UTC (rev 336975)
@@ -741,6 +741,15 @@
     are larger than 2GB.
    </simpara></note>'>

+<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
+    As of PHP 5.6.1 can also be specified as <constant>INI_SCANNER_TYPED</constant>.
+    In this mode boolean, null and integer types are preserved when possible.
+    String values <literal>"true"</literal>, <literal>"on"</literal> and \
<literal>"yes"</literal> +    are converted to &true;. <literal>"false"</literal>, \
<literal>"off"</literal>, <literal>"no"</literal> +    and <literal>"none"</literal> \
are considered &false;. <literal>"null"</literal> is converted to &null; +    in \
typed mode. Also, all numeric strings are converted to integer type if it is \
possible. +   </para>'>
+
 <!-- GNUPG -->
 <!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">The gnupg \
identifier, from a call to  <function>gnupg_init</function> or \
<classname>gnupg</classname>.</para>'>

Modified: phpdoc/en/trunk/reference/filesystem/functions/parse-ini-file.xml
===================================================================
--- phpdoc/en/trunk/reference/filesystem/functions/parse-ini-file.xml	2015-06-15 \
                22:13:49 UTC (rev 336974)
+++ phpdoc/en/trunk/reference/filesystem/functions/parse-ini-file.xml	2015-06-16 \
05:05:37 UTC (rev 336975) @@ -55,6 +55,7 @@
        <constant>INI_SCANNER_RAW</constant>. If <constant>INI_SCANNER_RAW</constant>
        is supplied, then option values will not be parsed.
       </para>
+      &ini.scanner.typed;
      </listitem>
     </varlistentry>
    </variablelist>
@@ -83,6 +84,12 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.0.0</entry>
+       <entry>
+         Added new <constant>INI_SCANNER_TYPED</constant> mode.
+       </entry>
+      </row>
+      <row>
        <entry>5.3.0</entry>
        <entry>
          Added optional <parameter>scanner_mode</parameter> parameter.
@@ -301,8 +308,8 @@
    <simpara>
     There are reserved words which must not be used as keys for
     ini files.  These include: null, yes, no, true, false, on, off, none.
-    Values null, off, no and false result in "".
-    Values on, yes and true result in "1".
+    Values null, off, no and false result in "", and values on, yes and true result
+    in "1", unless <constant>INI_SCANNER_TYPED</constant> mode is used (as of PHP \
                5.6.1).
     Characters <literal>?{}|&amp;~!()^"</literal> must not be used anywhere in
     the key and have a special meaning in the value.
    </simpara>

Modified: phpdoc/en/trunk/reference/filesystem/functions/parse-ini-string.xml
===================================================================
--- phpdoc/en/trunk/reference/filesystem/functions/parse-ini-string.xml	2015-06-15 \
                22:13:49 UTC (rev 336974)
+++ phpdoc/en/trunk/reference/filesystem/functions/parse-ini-string.xml	2015-06-16 \
05:05:37 UTC (rev 336975) @@ -54,6 +54,7 @@
        <constant>INI_SCANNER_RAW</constant>. If <constant>INI_SCANNER_RAW</constant>
        is supplied, then option values will not be parsed.
       </para>
+      &ini.scanner.typed;
      </listitem>
     </varlistentry>
    </variablelist>
@@ -74,8 +75,8 @@
    <simpara>
     There are reserved words which must not be used as keys for
     ini files.  These include: null, yes, no, true, false, on, off, none.
-    Values null, off, no and false result in "".
-    Values on, yes and true result in "1".
+    Values null, off, no and false result in "", and values on, yes and true result
+    in "1", unless <constant>INI_SCANNER_TYPED</constant> mode is used.
     Characters <literal>?{}|&amp;~![()^"</literal> must not be used anywhere in
     the key and have a special meaning in the value.
    </simpara>



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

[prev in list] [next in list] [prev in thread] [next in thread]