KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.compareToIgnoreCase(String) — tekenreeksen vergelijken zonder onderscheid naar hoofdletters

Vergelijk twee tekenreeksen lexicografisch zonder onderscheid tussen hoofdletters en kleine letters, en lees hun volgorde af aan het teken van de geretourneerde `int`.

Versie: Java SE 21

Syntax

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) is een instantiemethode van String. De aanroep left.compareToIgnoreCase(right) vergelijkt twee tekenreeksen lexicografisch zonder onderscheid tussen hoofdletters en kleine letters. Het resultaat is een int: < 0 betekent dat left vóór right komt, == 0 dat ze voor deze vergelijking gelijk zijn, en > 0 dat left na right komt. Controleer het teken en ga er niet van uit dat het resultaat altijd -1, 0 of 1 is.

In Java SE 21 heeft het resultaat hetzelfde teken als bij compareTo nadat Character.toLowerCase(Character.toUpperCase(cp)) op elk Unicode-codepunt cp van beide tekenreeksen is toegepast. De oorspronkelijke tekenreeksen veranderen niet. De methode houdt geen rekening met taal- of regioregels. Gebruik java.text.Collator met de juiste Locale om tekst volgens de regels van een bepaalde taal te sorteren.

Gebruik compareTo als hoofdletters en kleine letters van invloed moeten zijn op de lexicografische volgorde, en equalsIgnoreCase als je alleen een boolean nodig hebt die aangeeft of de tekenreeksen zonder dat onderscheid gelijk zijn. Als left of right null is, werpt left.compareToIgnoreCase(right) een NullPointerException op. Als left niet null is, geeft left.equalsIgnoreCase(null) false terug.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        String first = "apple";
        String second = "Banana";

        System.out.println(first.compareToIgnoreCase("APPLE"));
        System.out.println(Integer.signum(first.compareToIgnoreCase(second)));
        System.out.println(Integer.signum(second.compareToIgnoreCase(first)));
    }
}

Resultaat

0
-1
1

`apple` en `APPLE` leveren `0` op. `apple` komt vóór `Banana`; als je de vergelijking omkeert, verandert het teken. De laatste twee regels gebruiken `Integer.signum` om de resultaten om te zetten naar `-1` en `1`.

Gerelateerde lessen

  • Java · Les 63 · Basis · Versie: 2

Bronnen