cvs: /phpdoc/functions misc.sgml

ssb Tue Aug 31 13:55:43 1999 EDT Modified files: /phpdoc/functions misc.sgml Log: Added a note about the length of uniqid()'s return value. Sascha, could you verify the stuff I write about lcg? Index: phpdoc/functions/misc.sgml diff -u phpdoc/functions/misc.sgml:1.4 phpdoc/functions/misc.sgml:1.5 --- phpdoc/functions/misc.sgml:1.4 Sun Aug 29 06:17:47 1999 +++ phpdoc/functions/misc.sgml Tue Aug 31 13:55:42 1999 @@ -523,13 +523,27 @@ <funcsynopsis> <funcdef>int <function>uniqid</function></funcdef> <paramdef>string <parameter>prefix</parameter></paramdef> + <paramdef>boolean <parameter><optional>lcg</optional></parameter></paramdef> </funcsynopsis> <simpara> <function>uniqid</function> returns a prefixed unique identifier based on current time in microseconds. The prefix can be useful for instance if you generate identifiers simultaneously on several hosts that might happen to generate the identifier at the - same microsecond. The prefix can be up to 114 characters long. + same microsecond. <parameter>prefix</parameter> can be up to 114 + characters long. + </simpara> + <simpara> + If the optional <parameter>lcg</parameter> parameter is true, + <function>uniqid</function> will add additional "combined LCG" + entropy at the end of the return value, which should make the + results more unique. + </simpara> + <simpara> + Without an empty prefix, the returned string will be 13 + characters long. If <parameter>lcg</parameter> is true, it will + be 23 characters. + </simpara> <para> If you need a unique identifier or token and you intend to give out that token to the user via the network (i.e. session cookies),