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.