KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.compareTo — lexicografische vergelijking

String.compareTo vergelijkt tekenreeksen lexicografisch. Het teken van het resultaat bepaalt de volgorde; nul betekent dat de inhoud gelijk is.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

public int compareTo(String anotherString)
// Usage: int result = left.compareTo(right);

String.compareTo retourneert een int: een negatief resultaat betekent dat de linker tekenreeks vóór de rechter staat; een positief resultaat betekent dat deze erna staat. Nul komt overeen met gelijkheid volgens equals.

Bij de vergelijking wordt onderscheid gemaakt tussen hoofdletters en kleine letters, en worden UTF-16-code-eenheden (char) gebruikt, geen taalregels. Het resultaat is het verschil tussen de eerste verschillende eenheden; als de ene tekenreeks een prefix is van de andere, is het de lengteverschil. Ga er niet van uit dat het resultaat alleen -1, 0 of 1 is: controleer het teken.

Een null-argument veroorzaakt een NullPointerException. Gebruik Collator voor taalgevoelige vergelijkingen.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        System.out.println("cat".compareTo("car"));
        System.out.println("car".compareTo("cart"));
        System.out.println("cat".compareTo("cat"));
        System.out.println("A".compareTo("a") < 0);
    }
}

Resultaat

2
-1
0
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen