[PHP-DEV] CVS update: php3/doc/functions From: ssb (php-dev <email protected>)
Date: 10/26/98

Date: Monday October 26, 1998 @ 10:22
Author: ssb

Update of /repository/php3/doc/functions
In directory asf:/u2/tmp/cvs-serv24691

Modified Files:
        array.sgml
Log Message:
added uksort()

Index: php3/doc/functions/array.sgml
diff -c php3/doc/functions/array.sgml:1.25 php3/doc/functions/array.sgml:1.26
*** php3/doc/functions/array.sgml:1.25 Fri Sep 11 09:34:39 1998
--- php3/doc/functions/array.sgml Mon Oct 26 10:22:38 1998
***************
*** 665,674 ****
     </refsect1>
    </refentry>
  
    <refentry id="function.usort">
     <refnamediv>
      <refname>usort</refname>
! <refpurpose>Sort an array using a user-define comparison function</refpurpose>
     </refnamediv>
     <refsect1>
      <title>Description</title>
--- 665,717 ----
     </refsect1>
    </refentry>
  
+ <refentry id="function.uksort">
+ <refnamediv>
+ <refname>uksort</refname>
+ <refpurpose>Sort an array by keys using a user-defined comparison function</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>void <function>uksort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>function <parameter>cmp_function</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ This function will sort the keys of an array using a
+ user-supplied comparison function. If the array you wish to sort
+ needs to be sorted by some non-trivial criteria, you should use
+ this function.
+ <example>
+ <title><function>usort</function> example</title>
+ <programlisting>
+ function mycompare($a, $b) {
+ if ($a == $b) return 0;
+ return ($a > $b) ? -1 : 1;
+ }
+ $a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");
+ uksort($a, mycompare);
+ while(list($key, $value) = each($a)) {
+ echo "$key: $value\n";
+ }
+ </programlisting></example>
+ This example would display:
+ <computeroutput>
+ 20: twenty
+ 10: ten
+ 4: four
+ 3: three
+ </computeroutput>
+ <para>
+ See also <function>arsort</function>, <function>asort</function>,
+ <function>ksort</function>, <function>rsort</function> and <function>sort</function>.
+ </refsect1>
+ </refentry>
+
    <refentry id="function.usort">
     <refnamediv>
      <refname>usort</refname>
! <refpurpose>Sort an array by values using a user-defined comparison function</refpurpose>
     </refnamediv>
     <refsect1>
      <title>Description</title>
***************
*** 678,695 ****
       <paramdef>function <parameter>cmp_function</parameter></paramdef>
      </funcsynopsis>
      <para>
! This function will sort an array using a user-supplied comparison function.
! If the array you wish to sort needs to be sorted by some non-trivial
! criteria, you should use this function.
       <example>
        <title><function>usort</function> example</title>
          <programlisting>
  function cmp($a,$b) {
! if($a==$b) return 0;
! return ($a>$b) ? -1:1;
  }
  $a = array(3,2,5,6,1);
! usort($a,cmp);
  while(list($key,$value) = each($a)) {
      echo "$key: $value\n";
  }
--- 721,739 ----
       <paramdef>function <parameter>cmp_function</parameter></paramdef>
      </funcsynopsis>
      <para>
! This function will sort an array by its values using a
! user-supplied comparison function. If the array you wish to sort
! needs to be sorted by some non-trivial criteria, you should use
! this function.
       <example>
        <title><function>usort</function> example</title>
          <programlisting>
  function cmp($a,$b) {
! if ($a == $b) return 0;
! return ($a > $b) ? -1 : 1;
  }
  $a = array(3,2,5,6,1);
! usort($a, cmp);
  while(list($key,$value) = each($a)) {
      echo "$key: $value\n";
  } 

--
PHP Development Mailing List   http://www.php.net/
To unsubscribe send an empty message to php-dev-unsubscribe <email protected>
For help: php-dev-help <email protected>