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.