CKTIS / Java
String.split — découper du texte avec une expression régulière
String.split renvoie un tableau de fragments de texte séparés par les correspondances d’une expression régulière. Le paramètre limit contrôle le nombre de découpages et le traitement des éléments vides en fin de tableau.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);String.split renvoie un String[] contenant les fragments dans leur ordre d’apparition, sans les séparateurs correspondants. En l’absence de correspondance, le résultat contient un seul élément : le texte d’entrée complet.
split(regex) équivaut à split(regex, 0) : les éléments vides en fin de tableau sont supprimés. Avec limit < 0, ils sont conservés. Avec limit > 0, la méthode effectue au plus limit - 1 découpages ; le dernier élément contient le texte restant et le tableau comporte au plus limit éléments.
regex est une expression régulière, et non un simple séparateur. Écrivez un point littéral sous la forme "\\." ; pour protéger un séparateur littéral quelconque, utilisez Pattern.quote(separator) de java.util.regex.Pattern. Un motif invalide déclenche PatternSyntaxException.
Avec limit == 1, le texte n’est pas découpé, même si le motif correspond au début du texte. Lorsque le découpage se fait sur une correspondance qui consomme des caractères au début du texte, il produit un élément vide en tête. Une correspondance de largeur nulle au début n’en produit pas. Avec limit == 0, si tous les éléments issus du découpage sont vides, ils sont tous supprimés, y compris le premier. Par exemple, ",".split(",", 0) renvoie un tableau vide.
Exemples
import java.util.Arrays;
public class Main {
public static void main(String[] args) {
String text = "red.blue..";
System.out.println(Arrays.toString(text.split("\\.")));
System.out.println(Arrays.toString(text.split("\\.", -1)));
System.out.println(Arrays.toString(text.split("\\.", 2)));
}
}Résultat
[red, blue] [red, blue, , ] [red, blue..]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.