Méthodes String

List<String> arguments

String separator

Exemple :

Double myDouble = 12.34;

String myString = 

   String.valueOf(myDouble);

System.assertEquals(

  '12.34', myString);

Exemple :

List<Integer> ls = 

  new List<Integer>();

ls.add(10);

ls.add(20);

String strList = 

   String.valueOf(ls);

System.assertEquals(

  '(10, 20)', strList);

Si l'argument n'est pas une chaîne, la méthode valueOf le convertit en chaîne en appelant la méthode toString dans l'argument, si disponible, ou toute méthode toString remplacée si l'argument est un type défini par l'utilisateur. Sinon, si aucune méthode toString n'est disponible, elle renvoie une représentation de chaîne de l'argument.

Si maxWidth est inférieur à quatre, cette méthode lève une exception d'exécution.

String s = 'Hello Maximillian';

String s2 = 

   s.abbreviate(8);

System.assertEquals(

   'Hello...', s2);

System.assertEquals(

   8, s2.length());

Integer offset

Notez que le décalage n'est pas obligatoirement le caractère le plus à gauche de la chaîne renvoyée ou le premier caractère qui suit les ellipses, mais il figure quelque part dans le résultat. Dans tous les cas, abbreviate ne renvoie pas une chaîne de longueur supérieure à maxWidth.

Si maxWidth est trop petit, cette méthode lève une exception d'exécution.

Cette méthode est basée sur son équivalent abbreviate dans la bibliothèque Apache Commons Lang StringUtils.

String s = 

   'Hello Maximillian';

// Start at M

String s2 = 

   s.abbreviate(9,6);

System.assertEquals(

   '...Max...', s2);

System.assertEquals(

   9, s2.length());

String padStr

• Un nombre entier négatif si la chaîne qui a appelé la méthode de façon lexicographique précède compString
• Un nombre entier positif si la chaîne qui a appelé la méthode de façon lexicographique suit compString
• Zéro si les chaînes sont égales

String myString1 = 'abcde';

String myString2 = 'abcd';

Integer result = 

   myString1.compareTo(myString2);

System.assertEquals(result, 1);

Notez que cette méthode renvoie 0 chaque fois que la méthode equals renvoie true.

Si compString est une chaîne vide ou si la chaîne actuelle est vide, cette méthode renvoie true.

Si compString est null, cette méthode renvoie une exception d'exécution.

Si compString est une chaîne vide, cette méthode renvoie une chaîne vide.

Si compString est null, cette méthode lève une exception d'exécution.

String s = 'Hello Jane';

String d1 = 

   s.difference('Hello Max');

System.assertEquals(

   'Max',

   d1);

String d2 = 

   s.difference('Goodbye');

System.assertEquals(

   'Goodbye',

   d2);

String myString1 = 'abcde';

String myString2 = 'abcd';

Boolean result = 

   myString1.equals(myString2);

System.assertEquals(result, false);

Notez que l'opérateur == exécute également une comparaison de chaîne, mais il n'est pas sensible à la casse pour se conformer aux sémantiques Apex. (== est sensible à la casse pour une comparaison d'ID pour la même raison).

Si la chaîne contient une virgule, un saut de ligne ou un guillemet double, la chaîne est renvoyée entre guillemets doubles. De même, tout caractère guillemet double de la chaîne est échappé avec un autre guillemet double.

Si la chaîne ne contient pas de virgule, de saut de ligne ou de guillemet double, elle est renvoyée sans modification.

Cette méthode est basée sur son équivalent escapeCsv dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   'Max1, "Max2"';

String s2 = 

   s1.escapeCsv();

System.assertEquals(

   '"Max1, ""Max2"""', 

    s2);

À la différence des chaînes Apex, dans les chaînes EcmaScript un guillemet unique et une barre oblique (/) sont échappés.

Cette méthode est basée sur son équivalent escapeEcmaScript dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = '"grade": 3.9/4.0';

String s2 = s1.escapeEcmaScript();

System.debug(s2);

// Output is:

// \"grade\": 3.9\/4.0

System.assertEquals(

   '\\"grade\\": 3.9\\/4.0', 

    s2);

Cette méthode est basée sur son équivalent escapeHtml3 dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.escapeHtml3();

System.debug(s2);

// Output:

// &quot;&lt;Black&amp;

// White&gt;&quot;

Cette méthode est basée sur son équivalent escapeHtml4 dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.escapeHtml4();

System.debug(s2);

// Output:

// &quot;&lt;Black&amp;

// White&gt;&quot;

Prend en charge uniquement les cinq entités XML de base (gt, lt, quot, amp, apos). Ne prend pas en charge les DTD ou les entités externes. Les caractères Unicode supérieurs à 0x7f ne sont pas échappés.

Cette méthode est basée sur son équivalent escapeXml dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.escapeXml();

System.debug(s2);

// Output:

// &quot;&lt;Black&amp;

// White&gt;&quot;

La distance Levenshtein est le nombre de modifications nécessaires pour changer une chaîne en une autre chaîne. Chaque changement est une modification de caractère unique (suppression, insertion ou substitution).

String s = 'Hello Joe';

Integer i = 

   s.getLevenshteinDistance(

      'Hello Max');

System.assertEquals(

   3, i);

Integer threshold

La distance Levenshtein est le nombre de modifications nécessaires pour changer une chaîne en une autre chaîne. Chaque changement est une modification de caractère unique (suppression, insertion ou substitution).

Exemple :

Dans cet exemple, la distance Levenshtein est 3, mais l'argument de seuil est 2, qui est inférieur à la distance, donc cette méthode renvoie -1.

String s = 'Hello Jane';

Integer i = 

   s.getLevenshteinDistance(

      'Hello Max', 2);

System.assertEquals(

   -1, i);

Integer i

Exemple :

String s1 = 'abcd';

String s2 = 'xc';

Integer result = 

   s1.indexOfAny(s2);

System.assertEquals(

   2, result);

Exemple :

String s1 = 'abcd';

String s2 = 'xc';

Integer result = 

   s1.indexOfAnyBut(s2);

System.assertEquals(

   0, result);

Integer startPosition

Un point décimal (1.2) n'est pas un chiffre Unicode.

Un point décimal (1.2) n'est pas un chiffre Unicode.

Integer endPosition

Si la sous-chaîne ne se présente pas ou si endPosition est négatif, cette méthode renvoie -1. Si endPosition est supérieur au dernier index de la chaîne actuelle, la chaîne entière est recherchée.

Exemple :

String s1 = 'abcdaacd';

Integer i1 = 

   s1.lastIndexOf('c', 7);

System.assertEquals(

   6, i1);

Integer i2 = 

   s1.lastIndexOf('c', 3);

System.assertEquals(

   2, i2);

Si la sous-chaîne ne se présente pas, cette méthode renvoie -1.

Exemple :

String s1 = 'abcdaacd';

Integer i1 = 

   s1.lastIndexOfIgnoreCase('DAAC');

System.assertEquals(

   3, i1);

Integer endPosition

Si la sous-chaîne ne se présente pas ou si endPosition est négatif, cette méthode renvoie -1. Si endPosition est supérieur au dernier index de la chaîne actuelle, la chaîne entière est recherchée.

Exemple :

String s1 = 'abcdaacd';

Integer i1 = 

   s1.lastIndexOfIgnoreCase('C', 7);

System.assertEquals(

   6, i1);

Si length est supérieur à la taille de la chaîne, la chaîne entière est renvoyée.

Exemple :

String s1 = 'abcdaacd';

String s2 = 

   s1.left(3);

System.assertEquals(

   'abc', s2);

Si length est inférieur ou égal à la taille de la chaîne actuelle, la chaîne entière est renvoyée sans remplissage.

Exemple :

String s1 = 'abc';

String s2 = 

   s1.leftPad(5);

System.assertEquals(

   '  abc', s2);

Integer length

Si startIndex est négatif, il est considéré comme étant égal à zéro.

Si length est négatif ou zéro, une chaîne vide est renvoyée. Si length est supérieur aux caractères restants, le reste de la chaîne est renvoyé.

Cette méthode est similaire aux méthodes substring(startIndex) et substring(startIndex, endIndex), à l'exception du deuxième argument qui correspond au nombre de caractères à renvoyer.

Exemple :

String s = 'abcde';

String s2 = s.mid(2, 3);

System.assertEquals(

   'cde', s2);

Cette méthode est basée sur son équivalent normalizeSpace dans la bibliothèque Apache Commons Lang StringUtils.

Exemple :

String s1 = 

   'Salesforce \t     force.com';

String s2 = 

   s1.normalizeSpace();

System.assertEquals(

   'Salesforce force.com', s2);

Exemple :

String s1 = 'Salesforce and force.com';

String s2 = 

   s1.remove('force');

System.assertEquals(

   'Sales and .com', s2);

Exemple :

String s1 = 'Salesforce and force.com';

String s2 = 

   s1.removeEnd('.com');

System.assertEquals(

   'Salesforce and force', s2);

Exemple :

String s1 = 'Salesforce and force.com';

String s2 = 

   s1.removeEndIgnoreCase('.COM');

System.assertEquals(

   'Salesforce and force', s2);

Exemple :

String s1 = 'Salesforce and force.com';

String s2 = 

   s1.removeStart('Sales');

System.assertEquals(

   'force and force.com', s2);

Exemple :

String s1 = 'Salesforce and force.com';

String s2 = 

   s1.removeStartIgnoreCase('SALES');

System.assertEquals(

   'force and force.com', s2);

Exemple :

String s1 = 'SFDC';

String s2 = 

   s1.repeat(2);

System.assertEquals(

   'SFDCSFDC', s2);

Integer numTimes

Exemple :

String s1 = 'SFDC';

String s2 = 

   s1.repeat('-', 2);

System.assertEquals(

   'SFDC-SFDC', s2);

String replacement

String replacement

String replacement

Si length est supérieur à la taille de la chaîne, la chaîne entière est renvoyée.

Exemple :

String s1 = 'Hello Max';

String s2 = 

   s1.right(3);

System.assertEquals(

   'Max', s2);

Si length est inférieur ou égal à la taille de la chaîne actuelle, la chaîne entière est renvoyée sans remplissage.

Exemple :

String s1 = 'abc';

String s2 = 

   s1.rightPad(5);

System.assertEquals(

   'abc  ', s2);

Integer limit

Les sous-chaînes sont placées dans la liste dans le même ordre que dans la chaîne. Si regExp ne correspond à aucune partie de la chaîne, la liste résultante contient un seul élément avec la chaîne d'origine.

Reportez-vous également à Exemple de fractionnement de chaîne.

Pour plus d'informations sur les types de caractère utilisés, reportez-vous à java.lang.Character.getType(char).

Exemple :

String s1 = 'Force.com platform';

List<String> ls = 

   s1.splitByCharacterType();

System.debug(ls);

// Writes this output:

// (F, orce, ., com,  , platform)

Pour plus d'informations sur les types de caractère utilisés, reportez-vous à java.lang.Character.getType(char).

Exemple :

String s1 = 'Force.com platform';

List<String> ls = 

   s1.splitByCharacterTypeCamelCase();

System.debug(ls);

// Writes this output:

// (Force, ., com,  , platform)

Integer endIndex

Exemple :

String s1 = 'Force.com.platform';

String s2 = 

   s1.substringAfter('.');

System.assertEquals(

   'com.platform', s2);

Exemple :

String s1 = 'Force.com.platform';

String s2 = 

   s1.substringAfterLast('.');

System.assertEquals(

   'platform', s2);

Exemple :

String s1 = 'Force.com.platform';

String s2 = 

   s1.substringBefore('.');

System.assertEquals(

   'Force', s2);

Exemple :

String s1 = 'Force.com.platform';

String s2 = 

   s1.substringBeforeLast('.');

System.assertEquals(

   'Force.com', s2);

Exemple :

String s1 = 'tagYellowtag';

String s2 = 

   s1.substringBetween('tag');

System.assertEquals(

   'Yellow', s2);

String close

Exemple :

String s1 = 'xYellowy';

String s2 = 

   s1.substringBetween('x','y');

System.assertEquals(

   'Yellow', s2);

String close

Une majuscule et une initiale majuscule sont converties en minuscules, et une minuscule est convertie en majuscule.

Exemple :

String s1 = 'Force.com';

String s2 = 

   s1.swapCase();

System.assertEquals(

   'fORCE.COM', s2);

Les caractères de contrôle ASCII de début et de fin, tels que les tabulations et les nouvelles lignes, sont également supprimés. Les caractères d'espace et de contrôle qui ne sont pas placés au début ou à la fin de la phrase ne sont pas supprimés.

Si la chaîne est placée entre guillemets doubles et contient une virgule, un saut de ligne ou un guillemet double, les guillemets sont supprimés. De même, tout caractère guillemet double échappé (paire de guillemets doubles) est réduit à un seul guillemet double.

Si la chaîne n'est pas placée entre guillemets doubles, ou si elle l'est et ne contient pas de virgule, de saut de ligne ou de double guillemet, elle est renvoyée inchangée.

Cette méthode est basée sur son équivalent unescapeCsv dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"Max1, ""Max2"""';

String s2 = 

   s1.unescapeCsv();

System.assertEquals(

   'Max1, "Max2"', 

    s2);

Cette méthode est basée sur son équivalent unescapeEcmaScript dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '\"3.8\",\"3.9\"';

String s2 = 

   s1.unescapeEcmaScript();

System.assertEquals(

   '"3.8","3.9"',

   s2);

Cette méthode est basée sur son équivalent unescapeHtml3 dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.unescapeHtml3();

System.assertEquals(

   '"<Black&White>"',

   s2);

Cette méthode est basée sur son équivalent unescapeHtml4 dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.unescapeHtml4();

System.assertEquals(

   '"<Black&White>"',

   s2);

Prend en charge uniquement les cinq entités XML de base (gt, lt, quot, amp, apos). Ne prend pas en charge les DTD ou les entités externes.

Cette méthode est basée sur son équivalent unescapeXml dans la bibliothèque Apache Commons Lang StringEscapeUtils.

Exemple :

String s1 = 

   '"<Black&White>"';

String s2 = 

   s1.unescapeXml();

System.assertEquals(

   '"<Black&White>"',

   s2);