WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.compareTo — lexikografischer Vergleich

String.compareTo vergleicht Zeichenfolgen lexikografisch. Das Vorzeichen des Ergebnisses bestimmt die Reihenfolge; null bedeutet gleichen Inhalt.

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

Syntax

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

String.compareTo gibt einen int zurück: Ein negatives Ergebnis bedeutet, dass die linke Zeichenfolge vor der rechten steht; ein positives bedeutet, dass sie danach steht. Null entspricht der Gleichheit gemäß equals.

Der Vergleich unterscheidet Groß- und Kleinschreibung und verwendet UTF-16-Codeeinheiten (char), keine sprachlichen Regeln. Das Ergebnis ist die Differenz der ersten unterschiedlichen Einheiten; ist eine Zeichenfolge Präfix der anderen, entspricht es der Längendifferenz. Gehe nicht davon aus, dass das Ergebnis nur -1, 0 oder 1 ist: Prüfe das Vorzeichen.

Ein null-Argument verursacht eine NullPointerException. Für sprachabhängige Vergleiche ist Collator vorgesehen.

Beispiele

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);
    }
}

Ergebnis

2
-1
0
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen