KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.equals — tekenreeksinhoud vergelijken

String.equals vergelijkt tekenreeksinhoud en maakt daarbij onderscheid tussen hoofdletters en kleine letters. De operator == vergelijkt de objectidentiteit, niet de inhoud.

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

Syntax

public boolean equals(Object anObject)

String.equals heeft de signatuur public boolean equals(Object anObject). De methode geeft alleen true terug als het argument een niet-null-verwijzing is naar een String met exact dezelfde tekenreeks. Er wordt onderscheid gemaakt tussen hoofdletters en kleine letters: "Java".equals("java") geeft false terug.

Bij verwijzingen controleert == of ze naar hetzelfde object verwijzen. In het voorbeeld maakt new String("Java") een afzonderlijk object aan. Daarom geeft a.equals(b) true terug, terwijl a == b false oplevert.

Een argument van een ander type, zoals StringBuilder, levert ook bij dezelfde inhoud false op. a.equals(null) geeft false terug als a niet null is. Een methode aanroepen via een null-verwijzing veroorzaakt een NullPointerException; met "Java".equals(missing) voorkom je dit probleem.

Documentatiebereik: Java SE 21. De runtime van de repository en de productie-runtime zijn niet geattesteerd.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        String a = "Java";
        String b = new String("Java");
        String missing = null;

        System.out.println(a.equals(b));
        System.out.println(a == b);
        System.out.println(a.equals("java"));
        System.out.println(a.equals(new StringBuilder("Java")));
        System.out.println(a.equals(missing));
        System.out.println("Java".equals(missing));
    }
}

Resultaat

true
false
false
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