Name

SPVM::Sort - Sorting Functions

Usage

# Sort a byte array in-place by asc order
my $array = [(byte)2, 3, 1];
Sort->sort_byte($array, 0, scalar @$array, method : int ($a : byte, $b : byte) {
  return $a <=> $b;
});

# Sort short array in-place by asc order
my $array = [(short)2, 3, 1];
Sort->sort_short($array, 0, scalar @$array, method : int ($a : short, $b : short) {
  return $a <=> $b;
});

# Sort int array in-place by asc order
my $array = [2, 3, 1];
Sort->sort_int($array, 0, scalar @$array, method : int ($a : int, $b : int) {
  return $a <=> $b;
});

# Sort long array in-place by asc order
my $array = [(long)2, 3, 1];
Sort->sort_long($array, 0, scalar @$array, method : int ($a : long, $b : long) {
  return $a <=> $b;
});

# Sort float array in-place by asc order
my $array = [(float)2, 3, 1];
Sort->sort_float($array, 0, scalar @$array, method : int ($a : float, $b : float) {
  return $a <=> $b;
});

# Sort double array in-place by asc order
my $array = [(double)2, 3, 1];
Sort->sort_double($array, 0, scalar @$array, method : int ($a : double, $b : double) {
  return $a <=> $b;
});

# Sort string array in-place by asc order
my $array = ["11", "1", "2", undef, ""];
Sort->sort_string($array, 0, scalar @$array, method : int ($a : string, $b : string) {
  return $a cmp $b;
});

# Sort object array in-place by asc order
my $minimals = new TestCase::Minimal[3];
$minimals->[0] = TestCase::Minimal->new;
$minimals->[0]{x} = 3;
$minimals->[0]{y} = 5;
$minimals->[1] = TestCase::Minimal->new;
$minimals->[1]{x} = 3;
$minimals->[1]{y} = 7;
$minimals->[2] = TestCase::Minimal->new;
$minimals->[2]{x} = 2;
$minimals->[2]{y} = 9;
Sort->sort_object($minimals, 0, scalar @$minimals, method : int ($object1 : object, $object2 : object) {
  my $minimal1 = (TestCase::Minimal)$object1;
  my $minimal2 = (TestCase::Minimal)$object2;
  
  return $minimal1->{x} <=> $minimal2->{x} || $minimal1->{y} <=> $minimal2->{y};
};

Description

Sort provides sorting functions. The sorting algorithm is a stable merge sort.

Class Methods

sort_byte

static method sort_byte : void ($array : byte[], $offset : int, $length : int, $comparator : Comparator::Byte)

Sort the range of the elements of byte array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Byte comparator is used to compare each element.

The array must be defined. Otherwise an exception will be thrown.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_byte_asc

static method sort_byte_asc : void ($array : byte[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_byte($array, $offset, $length, method : int ($a : byte, $b : byte) { return $a <=> $b; });

sort_byte_desc

static method sort_byte_desc : void ($array : byte[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_byte($array, $offset, $length, method : int ($a : byte, $b : byte) { return $b <=> $a; });

sort_double

static method sort_double : void ($array : double[], $offset : int, $length : int, $comparator : Comparator::Double)

Sort the range of the elements of double array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Double comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_double_asc

static method sort_double_asc : void ($array : double[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_double($array, $offset, $length, method : int ($a : double, $b : double) { return $a <=> $b; });

sort_double_desc

static method sort_double_desc : void ($array : double[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_double($array, $offset, $length, method : int ($a : double, $b : double) { return $b <=> $a; });

sort_float

static method static method sort_float : void ($array : float[], $offset : int, $length : int, $comparator : Comparator::Float)

Sort the range of the elements of float array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Float comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_float_asc

static method sort_float_asc : void ($array : float[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_float($array, $offset, $length, method : int ($a : float, $b : float) { return $a <=> $b; });

sort_float_desc

static method sort_float_desc : void ($array : float[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_float($array, $offset, $length, method : int ($a : float, $b : float) { return $b <=> $a; });

sort_int

static method sort_int : void ($array : int[], $offset : int, $length : int, $comparator : Comparator::Int)

Sort the range of the elements of int array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Int comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_int_asc

static method sort_int_asc : void ($array : int[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_int($array, $offset, $length, method : int ($a : int, $b : int) { return $a <=> $b; });

sort_int_desc

static method sort_int_desc : void ($array : int[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_int($array, $offset, $length, method : int ($a : int, $b : int) { return $b <=> $a; });

sort_long

static method sort_long : void ($array : long[], $offset : int, $length : int, $comparator : Comparator::Long)

Sort the range of the elements of long array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Long comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_long_asc

static method sort_long_asc : void ($array : long[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_long($array, $offset, $length, method : int ($a : long, $b : long) { return $a <=> $b; });

sort_long_desc

static method sort_long_desc : void ($array : long[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_long($array, $offset, $length, method : int ($a : long, $b : long) { return $b <=> $a; });

sort_object

static method sort_object : void ($objs : object[], $offset : int, $length : int, $comparator : Comparator)

Sort the range of the elements of object array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_short

static method sort_short : void ($array : short[], $offset : int, $length : int, $comparator : Comparator::Short)

Sort the range of the elements of short array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::Short comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_short_asc

static method sort_short_asc : void ($array : short[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_short($array, $offset, $length, method : int ($a : short, $b : short) { return $a <=> $b; });

sort_short_desc

static method sort_short_desc : void ($array : short[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_short($array, $offset, $length, method : int ($a : short, $b : short) { return $b <=> $a; });

sort_string

static method sort_string : void ($array : string[], $offset : int, $length : int, $comparator : Comparator::String)

Sort the range of the elements of string array in-place.

The sorted range is from the offset to the offset + the length - 1.

The Comparator::String comparator is used to compare each element.

The offset must be greater than or equal to 0. Otherwise an exception will be thrown.

The length must be greater than or equal to 0. Otherwise an exception will be thrown.

The comparator must be defined. Otherwise an exception will be thrown.

The offset + length must be less than or equal to the length of the elements. Otherwise an exception will be thrown.

sort_string_asc

static method sort_string_asc : void ($array : string[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_string($array, $offset, $length, method : int ($a : string, $b : string) { return $a cmp $b; });

sort_string_desc

static method sort_string_desc : void ($array : string[], $offset : int, $length : int)

The alias for the following code.

Sort->sort_string($array, $offset, $length, method : int ($a : string, $b : string) { return $b cmp $a; });