compare

Summary

Compares the Character object to another Character object.

Usage

public final Comparison compare(Character object)

Returns

A System.Comparison enumeration result representing whether the specified Character comparison object is less than, equal to, or greater than the current Character object.

Parameters

object

The Character object to compare to.

Description

Compares the Character object to another Character object. Returns one of the following System.Comparison enumeration values:

  • System.Comparison.LESS_THAN
  • System.Comparison.EQUAL
  • System.Comparison.GREATER_THAN

Examples

Basic Usage
1
2
3
4
5
import System;
 
char c = `a`;
Comparison result = c.compare(`b`);
Console.log(result == Comparison.EQUAL);
Sorting
1
2
3
4
5
import System;
 
char[] arr = [ `a`, `c`, `a`, `b` ];
arr.sort(); // 'System.Array<T>.sort' uses 'compare' to sort elements
Console.log(arr.join(", "));
Custom Sort
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import System;
import System.Assert;
 
char[] arr = [ `a`, `c`, `a`, `b` ];
arr.sort(Comparison(char a, char b) {
    if (a < b) {
        return Comparison.LESS_THAN;
    }
    else if (a > b) {
        return Comparison.GREATER_THAN;
    }
    else {
        assert(a == b);
        return Comparison.EQUAL;
    }
});
Console.log(arr.join(", "));

Share

HTML | BBCode | Direct Link