Re: cvs: phpdoc /en/reference/misc/functions define.xml

I agree it should be documented, as object to string conversion is not always automatic. example: $array[$object] = 2; Regards Richard A. Quadling wrote:

-----Original Message----- From: Hannes Magnusson [mailto:hannes.magnusson@gmail.com] Sent: 27 April 2007 13:41 To: Maciek Sokolewicz Cc: phpdoc@lists.php.net Subject: Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions define.xml Should we mention that define() also accepts objects with __toString() implemented.. or is that generally expected? -Hannes

Ha! That does got completely against what the dox currently say. It should be documented with an appropriate example otherwise users may read it as supporting ANY object, not just those with a __toString() method. Maybe document both class types - with and without a __toString() method to really drive the point home. Richard.

On 4/27/07, Maciek Sokolewicz <tularis@php.net> wrote:

    
tularis         Fri Apr 27 11:10:29 2007 UTC

Modified files:

    /phpdoc/en/reference/misc/functions define.xml

Log: define() also allows null and boolean values

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/misc/functions/defin

e.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/misc/functions/define.xml diff -u phpdoc/en/reference/misc/functions/define.xml:1.9

phpdoc/en/reference/misc/functions/define.xml:1.10

--- phpdoc/en/reference/misc/functions/define.xml:1.9 Fri

Apr 27 07:54:37 2007

+++ phpdoc/en/reference/misc/functions/define.xml Fri

Apr 27 11:10:29 2007

@@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id="function.define"> <refnamediv> <refname>define</refname> @@ -35,7 +35,9 @@

      <term><parameter>value</parameter></term>
      <listitem>
       <para>
-       The value of the constant; only scalar values, that       

is <type>integer</type>s, <type>float</type>s and <type>string</type>s are allowed.

+ The value of the constant; only scalar and

<type>null</type> values are allowed.

+ Scalar values are <type>integer</type>, + <type>float</type>, <type>string</type> or

<type>boolean</type> values.

</para> </listitem> </varlistentry>

-- Etienne Kneuss http://www.colder.ch colder@php.net Men never do evil so completely and cheerfully as when they do it from a religious conviction. -- Pascal