From: <bi...@us...> - 2011-03-06 15:06:37
|
Revision: 6831 http://oorexx.svn.sourceforge.net/oorexx/?rev=6831&view=rev Author: bigrixx Date: 2011-03-06 15:06:30 +0000 (Sun, 06 Mar 2011) Log Message: ----------- [ oorexx-Feature Requests-3196278 ] Add sort methods to all OrderedCollections. Modified Paths: -------------- docs/trunk/rexxref/collclasses.xml docs/trunk/rexxref/ooRexxOrderedCollectionClass.odg docs/trunk/rexxref/ooRexxOrderedCollectionClass.pdf docs/trunk/rexxref/ooRexxOrderedCollectionClass.png docs/trunk/rexxref/orderedcollectionclassmethods.xml Modified: docs/trunk/rexxref/collclasses.xml =================================================================== --- docs/trunk/rexxref/collclasses.xml 2011-03-06 15:02:15 UTC (rev 6830) +++ docs/trunk/rexxref/collclasses.xml 2011-03-06 15:06:30 UTC (rev 6831) @@ -707,6 +707,80 @@ </para> </section> +<section id="mthOrderedCollectionSort"><title>sort</title> +<indexterm><primary>sort method</primary> +<secondary>of OrderedCollection class</secondary></indexterm> +<indexterm><primary>method</primary> +<secondary>sort method</secondary> +<tertiary>of OrderedCollection class</tertiary></indexterm> + +<programlisting> +<![CDATA[ +>>-sort-------------------------------------------------------->< +]]> +</programlisting> + +<para>Sorts a a collection of Comparable items into ascending order using an algorithm that is not guaranteed to be stable. +See <link linkend="sortOrderedCollection">Sorting Arrays</link> for details. +</para> +</section> + +<section id="mthOrderedCollectionSortWith"><title>sortWith</title> +<indexterm><primary>sortWith method</primary> +<secondary>of OrderedCollection class</secondary></indexterm> +<indexterm><primary>method</primary> +<secondary>sortWith method</secondary> +<tertiary>of OrderedCollection class</tertiary></indexterm> + +<programlisting> +<![CDATA[ +>>-sortWith(comparator)---------------------------------------->< +]]> +</programlisting> + +<para>Sorts a collection of items into ascending order using an algorithm that is not guaranteed to be stable. +Ordering of elements is determined using the <emphasis role="italic">comparator</emphasis> argument. +See <link linkend="sortOrderedCollection">Sorting Arrays</link> for details. +</para> +</section> + +<section id="mthOrderedCollectionStableSort"><title>stableSort</title> +<indexterm><primary>stableSort method</primary> +<secondary>of OrderedCollection class</secondary></indexterm> +<indexterm><primary>method</primary> +<secondary>stableSort method</secondary> +<tertiary>of OrderedCollection class</tertiary></indexterm> + +<programlisting> +<![CDATA[ +>>-stableSort-------------------------------------------------->< +]]> +</programlisting> + +<para>Sorts a collection of Comparable items into ascending order using a stable Mergesort algorithm. +See <link linkend="sortOrderedCollection">Sorting Arrays</link> for details. +</para> +</section> + +<section id="mthOrderedCollectionStableSortWith"><title>stableSortWith</title> +<indexterm><primary>stableSortWith method</primary> +<secondary>of OrderedCollection class</secondary></indexterm> +<indexterm><primary>method</primary> +<secondary>stableSortWith method</secondary> +<tertiary>of OrderedCollection class</tertiary></indexterm> + +<programlisting> +<![CDATA[ +>>-stableSortWith(comparator)---------------------------------->< +]]> +</programlisting> + +<para>Sorts a collection of items into ascending order using a stable Mergesort algorithm. +Ordering of elements is determined using the <emphasis role="italic">comparator</emphasis> argument. +See <link linkend="sortOrderedCollection">Sorting Arrays</link> for details. +</para> +</section> + <section id="mthOrderedCollectionSubset"><title>subset</title> <indexterm><primary>subset method</primary> <secondary>of OrderedCollection class</secondary></indexterm> @@ -826,7 +900,7 @@ <note><title>Note</title> <para>The Array class also has available class methods that its metaclass, the <link linkend="clsClass">Class class</link>, defines. -It also inherits methods from the <link linkend="clsOrderedCollection">Ordered Collection +It also inherits methods from the <link linkend="clsOrderedCollection">OrderedCollection class</link>. </para></note> <para>Array objects are variable-sized. The dimensionality of an array is fixed, @@ -3192,8 +3266,8 @@ <note><title>Note</title> <para>The List class also has available class methods that its metaclass, metaclass, the <link linkend="clsClass">Class class</link>, defines. -It also inherits methods from the <link linkend="clsOrderedCollection">Ordered Collection -class</link>, although there are not currently any methods defined in that class. +It also inherits methods from the <link linkend="clsOrderedCollection">OrderedCollection +class</link>. </para></note> <section><title>Inherited Methods</title> @@ -4064,7 +4138,7 @@ <note><title>Note</title> <para>The Queue class also has available class methods that its metaclass, the <link linkend="clsClass">Class class</link>, defines. -It also inherits methods from the <link linkend="clsOrderedCollection">Ordered Collection +It also inherits methods from the <link linkend="clsOrderedCollection">OrderedCollection class</link>. </para></note> Modified: docs/trunk/rexxref/ooRexxOrderedCollectionClass.odg =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxOrderedCollectionClass.pdf =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/ooRexxOrderedCollectionClass.png =================================================================== (Binary files differ) Modified: docs/trunk/rexxref/orderedcollectionclassmethods.xml =================================================================== --- docs/trunk/rexxref/orderedcollectionclassmethods.xml 2011-03-06 15:02:15 UTC (rev 6830) +++ docs/trunk/rexxref/orderedcollectionclassmethods.xml 2011-03-06 15:06:30 UTC (rev 6831) @@ -4,8 +4,14 @@ <simplelist type="vert" columns="3"> <member><link linkend="mthOrderedCollectionAppend">append</link></member> <member><link linkend="mthOrderedCollectionAppendAll">appendAll</link></member> +<member><link linkend="mthOrderedCollectionDelete">delete</link></member> <member><link linkend="mthOrderedCollectionDifference">difference</link></member> +<member><link linkend="mthOrderedCollectionInsert">insert</link></member> <member><link linkend="mthOrderedCollectionIntersection">intersection</link></member> +<member><link linkend="mthOrderedCollectionSort">sort</link></member> +<member><link linkend="mthOrderedCollectionSortWish">sortWith</link></member> +<member><link linkend="mthOrderedCollectionStableSort">stableSort</link></member> +<member><link linkend="mthOrderedCollectionStableSortWith">stableSortWith</link></member> <member><link linkend="mthOrderedCollectionSubset">subset</link></member> <member><link linkend="mthOrderedCollectionUnion">union</link></member> <member><link linkend="mthOrderedCollectionXor">xor</link></member> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |