Difference between revisions of "PGsort"

From WeBWorK_wiki
Jump to navigation Jump to search
(from ur manpages)
 
(Clarified, more examples given by C C Heckman (January 2014))
Line 11: Line 11:
 
'''Params'''
 
'''Params'''
   
<blockquote> &amp;sort_subroutine is a subroutine of two variables which defines order. It's output must be -1, 0, 1 depending on whether the first variable is less than, equal to or greater than the second.<br /> @list is the list to be sorted.</blockquote>
+
<blockquote> &amp;sort_subroutine is a subroutine of two variables which defines order. Its output must be 0 or 1, with a 1 indicating the first argument is less than the second. <br /><br />@list is the list to be sorted.</blockquote>
   
 
'''Returns'''
 
'''Returns'''
Line 19: Line 19:
 
'''Examples'''
 
'''Examples'''
   
<blockquote> join(" ",PGsort( sub {$_[0] &lt;=&gt; $_[1]} , (23,2,10,11,11,31); ); returns "2 10 11 11 23 31"</blockquote>
+
<blockquote> join(" ",PGsort( sub {$_[0] &lt;=&gt; $_[1]} , (23,2,10,11,11,31) ); returns "2 10 11 11 23 31"</blockquote>
  +
<blockquote> PGsort (sub { ($_[0] % 2) &lt; ($_[1] % 2) }, @L ); will move the even numbers to the left of the odd numbers.</blockquote>
  +
<blockquote> PGsort( <br />
  +
&nbsp; &nbsp; &nbsp; sub { my ($P1, $P2) = @_;
  +
my $P1x = $P1 ->{data}[0], $P2x = $P2 -> {data}[0];
  +
if ($P1x < $P2x) { return 1; }<br />
  +
&nbsp; &nbsp; &nbsp;
  +
if ($P1x > $P2x) { return 0; }
  +
$P1 ->{data}[1] < $P2 -> {data}[1]; }
  +
<br />,
  +
( Point (2,2), Point (1,3), Point(2,1) ) ) <br />&nbsp; &nbsp; &nbsp; returns (Point (1,3), Point (2,1), Point (2,2)) (now in lexigraphical order)
  +
</blockquote>
   
 
'''Notes'''
 
'''Notes'''

Revision as of 00:59, 3 January 2014

PGSort

Description

General sorting macro

Syntax

PGsort( &sort_subroutine, @list);

Params

&sort_subroutine is a subroutine of two variables which defines order. Its output must be 0 or 1, with a 1 indicating the first argument is less than the second.

@list is the list to be sorted.

Returns

Returns list of elements in @list, ignoring duplicates. The order is unspecified.

Examples

join(" ",PGsort( sub {$_[0] <=> $_[1]} , (23,2,10,11,11,31) ); returns "2 10 11 11 23 31"

PGsort (sub { ($_[0] % 2) < ($_[1] % 2) }, @L ); will move the even numbers to the left of the odd numbers.

PGsort(

      sub { my ($P1, $P2) = @_; my $P1x = $P1 ->{data}[0], $P2x = $P2 -> {data}[0]; if ($P1x < $P2x) { return 1; }
      if ($P1x > $P2x) { return 0; } $P1 ->{data}[1] < $P2 -> {data}[1]; }
, ( Point (2,2), Point (1,3), Point(2,1) ) )
      returns (Point (1,3), Point (2,1), Point (2,2)) (now in lexigraphical order)

Notes

Using the perl sort directly in problems is not allowed for two reasons. The first is that the hardwired $a and $b variables used by sort can interfere with other values assigned to $a and $b. The second is that it is pretty easy to create closed loops with sort that hang the program. Currently nothing is done to prevent this, but later we may wish to modify num_sort and lex_sort to catch this problem.