reference/array/functions/krsort.xml
2ca090342977839edca2f7f4e52305a1b5da6095
...
...
@@ -3,20 +3,23 @@
3
3
<refentry xml:id="function.krsort" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>krsort</refname>
6
-
<refpurpose>Sort an array by key in reverse order</refpurpose>
6
+
<refpurpose>Sort an array by key in descending order</refpurpose>
7
7
</refnamediv>
8
8
<refsect1 role="description">
9
9
&reftitle.description;
10
10
<methodsynopsis>
11
-
<type>bool</type><methodname>krsort</methodname>
11
+
<type>true</type><methodname>krsort</methodname>
12
12
<methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
13
-
<methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter><initializer>SORT_REGULAR</initializer></methodparam>
13
+
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
14
14
</methodsynopsis>
15
15
<para>
16
-
Sorts an array by key in reverse order, maintaining key to data
17
-
correlations. This is useful mainly for associative arrays.
16
+
Sorts <parameter>array</parameter> in place by keys
17
+
in descending order.
18
18
</para>
19
+
&note.sort-unstable;
20
+
&note.reset-index;
19
21
</refsect1>
22
+

20
23
<refsect1 role="parameters">
21
24
&reftitle.parameters;
22
25
<para>
...
...
@@ -29,25 +32,37 @@
29
32
</para>
30
33
</listitem>
31
34
</varlistentry>
32
-
<varlistentry>
33
-
<term><parameter>sort_flags</parameter></term>
34
-
<listitem>
35
-
<para>
36
-
You may modify the behavior of the sort using the optional parameter
37
-
<parameter>sort_flags</parameter>, for details see
38
-
<function>sort</function>.
39
-
</para>
40
-
</listitem>
41
-
</varlistentry>
35
+
&sort.flags.parameter;
42
36
</variablelist>
43
37
</para>
44
38
</refsect1>
39
+

45
40
<refsect1 role="returnvalues">
46
41
&reftitle.returnvalues;
47
42
<para>
48
-
&return.success;
43
+
&return.true.always;
44
+
</para>
45
+
</refsect1>
46
+

47
+
<refsect1 role="changelog">
48
+
&reftitle.changelog;
49
+
<para>
50
+
<informaltable>
51
+
<tgroup cols="2">
52
+
<thead>
53
+
<row>
54
+
<entry>&Version;</entry>
55
+
<entry>&Description;</entry>
56
+
</row>
57
+
</thead>
58
+
<tbody>
59
+
&return.type.true;
60
+
</tbody>
61
+
</tgroup>
62
+
</informaltable>
49
63
</para>
50
64
</refsect1>
65
+

51
66
<refsect1 role="examples">
52
67
&reftitle.examples;
53
68
<para>
...
...
@@ -76,18 +91,17 @@ a = orange
76
91
</example>
77
92
</para>
78
93
</refsect1>
94
+

79
95
<refsect1 role="seealso">
80
96
&reftitle.seealso;
81
-
<para>
82
-
<simplelist>
83
-
<member><function>arsort</function></member>
84
-
<member><function>ksort</function></member>
85
-
<member>&seealso.array.sorting;</member>
86
-
</simplelist>
87
-
</para>
97
+
<simplelist>
98
+
<member><function>sort</function></member>
99
+
<member><function>ksort</function></member>
100
+
<member>&seealso.array.sorting;</member>
101
+
</simplelist>
88
102
</refsect1>
89
-
</refentry>
90
103

104
+
</refentry>
91
105
<!-- Keep this comment at the end of the file
92
106
Local variables:
93
107
mode: sgml
94
108



Tools (Spanish Manual)