CKTIS / Java
Comparer du texte avec String.contentEquals
Comparez un String à une CharSequence ou à un StringBuffer sans convertir l’argument en String.
Version : Java SE 21
Syntaxe
// Method declaration headers in java.lang.String
public boolean contentEquals(CharSequence cs)
public boolean contentEquals(StringBuffer sb)String.contentEquals(CharSequence) vérifie que les mêmes unités de code UTF-16 (valeurs char) se suivent dans le même ordre. La comparaison distingue majuscules et minuscules, ne normalise pas Unicode et fonctionne avec un StringBuilder sans conversion en String. En revanche, String.equals(Object) ne reconnaît qu’un autre String de contenu identique. contentEquals(StringBuffer) verrouille le tampon ; la surcharge CharSequence fait de même si l’argument est effectivement un StringBuffer. Les deux surcharges de contentEquals lèvent NullPointerException si l’argument est null.
Exemples
public class StringContentDemo {
public static void main(String[] args) {
String text = "abcd\u00E9";
CharSequence sequence = new StringBuilder(text);
System.out.println("contentEquals: " + text.contentEquals(sequence));
System.out.println("equals: " + text.equals(sequence));
StringBuffer buffer = new StringBuffer(text);
System.out.println("contentEquals(StringBuffer): " + text.contentEquals(buffer));
buffer.append('!');
System.out.println("contentEquals(StringBuffer) after append: " + text.contentEquals(buffer));
}
}
Résultat
contentEquals: true equals: false contentEquals(StringBuffer): true contentEquals(StringBuffer) after append: false
Le `StringBuilder` a le même contenu sans être un `String` : `contentEquals` renvoie `true` et `equals` renvoie `false`. La surcharge pour `StringBuffer` renvoie `true` avant l’ajout de `!`, puis `false`.
Leçons associées
- Java · Leçon 51 · Avancé · Version : 2