KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.equalsIgnoreCase — vergelijken zonder onderscheid tussen hoofdletters en kleine letters

String.equalsIgnoreCase vergelijkt tekenreeksen zonder onderscheid te maken tussen hoofdletters en kleine letters, onafhankelijk van de landinstellingen. De methode retourneert een boolean.

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

Syntax

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase vereist dat de tekenreeksen even lang zijn en dat de bijbehorende Unicode-codepunten overeenkomen. Codepunten komen overeen als ze identiek zijn of als Character.toLowerCase(Character.toUpperCase(int)) hetzelfde resultaat oplevert.

Een null-argument levert false op; aanroepen van de methode op een null-ontvanger veroorzaakt een NullPointerException. In tegenstelling tot deze methode maakt equals wel onderscheid tussen hoofdletters en kleine letters.

De methode houdt geen rekening met landinstellingen; gebruik Collator voor taalafhankelijke vergelijkingen. De methode beschouwt ß niet als gelijk aan SS: de lengtes verschillen.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        System.out.println("Java".equalsIgnoreCase("jAvA"));
        System.out.println("Java".equals("jAvA"));
        System.out.println("Java".equalsIgnoreCase(null));
        System.out.println("ß".equalsIgnoreCase("SS"));
    }
}

Resultaat

true
false
false
false

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