Fonctions d’exécution de chaîne X++

Cet article décrit les fonctions d’exécution de chaîne.

allumette

Recherche une chaîne ou une expression dans une autre chaîne.

int match(str pattern, str text)

Paramètres

Valeur retournée

1 si le modèle se trouve dans la chaîne ; sinon, 0 (zéro).

Remarques

La recherche ne respecte pas la casse. Les caractères spéciaux suivants peuvent être utilisés pour créer le modèle pour le paramètre de modèle .

• \: une barre oblique inverse (\) nullifie, ou s’échappe, le traitement spécial des caractères spéciaux, afin qu’un caractère spécial puisse être mis en correspondance comme une lettre normale. Une paire de barres obliques inverses est traduite en une barre oblique inverse non spécifique. Exemples :

  • match(« ab$cd »,"ab$cd ») ; retourne 0.
  • match(« ab\$cd »,"ab$cd ») ; retourne 0. La barre oblique inverse n’est pas échappée.
  • match(« ab\\$cd »,"ab$cd ») ; retourne 1. La barre oblique inverse et le signe dollar sont échappés.

• < ou ^ : Un crochet à angle gauche (<) ou un circonflexe (^) au début d’une expression est utilisé pour correspondre au début d’une ligne. Exemples :

  • match(« <abc »,"abcdef ») ; retourne 1.
  • match(« <abc »,"defabc ») ; retourne 0.
  • match(« ^abc »,"abcdef ») ; retourne 1.
  • match(« ^abc »,"defabc ») ; retourne 0.

• > ou $ : un crochet à angle droit (>) ou un signe dollar ($) à la fin de l’expression est utilisé pour correspondre à la fin d’une ligne. Exemples :

  • match(« abc> »,"abcdef ») ; retourne 0.
  • match(« abc> »,"defabc ») ; retourne 1.

• ? ou.: un point d’interrogation ( ?) ou un point (.) correspond à un caractère dans la même position. Exemples :

  • match(« abc.def »,"abc#def ») ; retourne 1.
  • match(« colou ?r »,"colouXr ») ; retourne 1.

• :x : un signe deux-points ( :) spécifie un groupe de caractères à mettre en correspondance, comme indiqué par le caractère qui suit immédiatement.

• :a : définit la correspondance sur les lettres. Exemples :

  • match(« ab :acd »,"ab#cd ») ; retourne 0.
  • match(« ab :acd »,"abxyzcd ») ; retourne 0.
  • match(« ab :acd »,"abxcd ») ; retourne 1.

• :d : définit la correspondance sur des caractères numériques. Exemples :

  • match(« ab :dcd »,"ab3cd ») ; retourne 1.
  • match(« ab :dcd »,"ab123cd ») ; retourne 0.
  • match(« ab :dcd »,"abcd ») ; retourne 0.

• :n : définit la correspondance sur les caractères alphanumériques. Exemples :

  • match(« ab :ncd »,"ab%cd« ) ; retourne 0.
  • match(« ab :ncd »,"ab9cd ») ; retourne 1.
  • match(« ab :ncd »,"abXcd ») ; retourne 1.

• :ESPACE : ESPACE est le caractère d’espace ( » « ). Définit la correspondance sur des espaces, des tabulations et des caractères de contrôle tels que Entrée (nouvelle ligne). Exemples :

  • match(« ab : cd »,"ab cd ») ; retourne 1.
  • match(« ab : cd »,"ab\ncd ») ; retourne 1.
  • match(« ab : cd »,"ab\tcd ») ; retourne 1.
  • match(« ab : cd »,"ab cd ») ; retourne 0. Seul le premier espace est mis en correspondance.

• *: une expression suivie d’un astérisque (« * ») nécessite une correspondance pour zéro, un ou plusieurs occurrences de l’expression précédente. Exemples :

  • match(« abc*d »,"abd ») ; retourne 1.
  • match(« abc*d »,"abcd ») ; retourne 1.
  • match(« abc*d »,"abcccd ») ; retourne 1.
  • match(« abc*d »,"abxd ») ; retourne 0.

• +: une expression suivie d’un signe plus (+) nécessite une correspondance pour une ou plusieurs occurrences de l’expression précédente. Exemples :

  • match(« abc+d »,"abd ») ; retourne 0.
  • match(« abc+d »,"abcd ») ; retourne 1
  • match(« abc+d »,"abcccd ») ; retourne 1.
  • match(« abc+d »,"abxd ») ; retourne 0.

• -: une expression suivie d’un signe moins (-) nécessite une correspondance pour zéro ou une occurrence de l’expression précédente. En d’autres termes, l’expression précédente est facultative. Exemples :

  • match(« colou-r »,"color ») ; retourne 1.
  • match(« colou-r »,"color ») ; retourne 1.

• [] : correspond à un caractère unique avec n’importe quel caractère placé entre crochets. Une plage de caractères peut être spécifiée par deux caractères séparés par un signe moins (-). Par exemple, [a-z] correspond à toutes les lettres entre a et z, [0-9] correspond à un chiffre, et [0-9a-f] correspond à un chiffre hexadécimal. Exemples :

  • match(« [abc] »,"apple ») ; retourne 1, car il correspond à la « pomme ».
  • match(« [abc] »,"kiwi ») ; retourne 0, parce que « kiwi » ne contient pas de a, b ou c.
  • match(« gr[ae]y »,"gris ») ; retourne 1. Cette expression correspond également à « gris ».
  • match(« gr[ae]y »,"graey ») ; retourne 0, car un seul caractère entre « gr » et « y » est mis en correspondance.

• [^] : Si le premier caractère du texte placé entre crochets est un circonflexe (^), l’expression correspond à tous les caractères, à l’exception des caractères placés entre crochets. Exemples :

  • match(« [^bc]at »,"bat ») ; retourne 0.
  • match(« [^bc]at »,"hat ») ; retourne 1.
  • match(« [^abc] »,"bat ») ; retourne 1. Tout ce qui n’est qu’un, b ou c est mis en correspondance. Par conséquent, le t est mis en correspondance.

strAlpha

Copie uniquement les caractères alphanumériques d’une chaîne.

str strAlpha(str _text)

Paramètres

Valeur retournée

Nouvelle chaîne qui contient tous les caractères alphanumériques de la chaîne spécifiée.

Remarques

Par exemple, strAlpha(« 2+2=5 is this correct ? ») renvoie la chaîne 225isthiscorrect.

Example

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

Compare deux chaînes de texte.

int strCmp(str text1, str text2)

Paramètres

Valeur retournée

0 si les deux chaînes sont identiques, 1 si la première chaîne trie précédemment, ou -1 si la deuxième chaîne trie précédemment.

Remarques

La comparaison effectuée par cette méthode respecte la casse.

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

Convertit tous les caractères majuscules en caractères minuscules et convertit tous les caractères qui ont des accents en caractères minuscules nonaccentés correspondants.

str strColSeq(str text)

Paramètres

Valeur retournée

Chaîne de texte convertie.

Remarques

La fonction strColSeq existe à des fins de compatibilité descendante. Cette fonction prend uniquement en charge le mappage pour les caractères occidentaux suivants :

• AàáâãäÀÁÂÃÃÃÄBCçÇDEèèéêëÈÉÊÊÊËFGHIìîïÏÍÎÏJKLMNñÑOòóôõöÓÕÖPQRSTUùúûüÙÚÛÜVWXYýÝZæåØØÅ
• aaaaaaaaaaabcccdeeeeeeeeefghiiiiiijklmnnnooooooooopqrstuuuuuvwxyyyz~~Ç~~Ç~Ç~Ç

Pour les fonctionnalités compatibles Unicode, utilisez l’interface de programmation d’applications Win32 LCMapString (API) via les classes DLL et DLLFunc .

Example

L’exemple suivant imprime abcdeabcde.

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

Crée une copie d’une chaîne à partir de laquelle la sous-chaîne spécifiée est supprimée.

str strDel(str _text, int _position, int _number)

Paramètres

Valeur retournée

Caractères restants copiés à partir de la chaîne.

Remarques

La fonction strDel est complémentaire à la fonction de sous-chaîne .

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

Recherche une chaîne pour la première occurrence de l’un des caractères spécifiés.

int strFind(str _text, str _characters, int _position, int _number)

Paramètres

Valeur retournée

Valeur de la position de la première occurrence de l’un des caractères spécifiés, ou 0 lorsqu’aucune valeur n’a été trouvée.

Remarques

Pour effectuer une recherche du début de la chaîne à la fin, utilisez 1 comme valeur du paramètre _position . Si la valeur du paramètre _number est négative, le système recherche le nombre de caractères vers l’arrière de la position spécifiée. La recherche ne respecte pas la casse. Voici un exemple.

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

La fonction strFind est complémentaire à la fonction strNFind .

strFmt

Met en forme la chaîne spécifiée et remplace toutes les occurrences de n par l’argument n.

str strFmt(str _string, ...)

Paramètres

Valeur retournée

Chaîne mise en forme.

Remarques

Si un argument n’est pas fourni pour un paramètre, le paramètre retourne «%n» dans la chaîne. La conversion de chaînes de valeurs du type réel est limitée à deux décimales. Les valeurs sont arrondies, non tronquées. La méthode System.String ::Format de Microsoft .NET Framework peut être utilisée pour obtenir plus de fonctionnalités, comme illustré dans l’exemple.

Example

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

strIns

Génère une chaîne en insérant une chaîne dans une autre.

str strIns(str _text1, str _text2, int _position)

Paramètres

Valeur retournée

Chaîne de texte combinée.

Remarques

La fonction strIns est complémentaire à la fonction strDel . Si la valeur du paramètre _position est supérieure à la longueur de la chaîne d’origine, la chaîne à insérer est ajoutée à la fin de la chaîne d’origine.

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

Génère une chaîne en utilisant uniquement les caractères de la première chaîne d’entrée spécifiée par la deuxième chaîne d’entrée.

str strKeep(str _text1, str _text2)

Paramètres

Valeur retournée

Chaîne des caractères conservés.

Remarques

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

La fonction strKeep est complémentaire à la fonction strRem .

strLen

Calcule la longueur de la chaîne spécifiée.

int strLen(str text)

Paramètres

Valeur retournée

Longueur de la chaîne spécifiée.

Remarques

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

strLine

Récupère une seule ligne d’une chaîne qui s’étend sur plusieurs lignes.

str strLine(str string, int count)

Paramètres

Valeur retournée

Ligne copiée de la chaîne spécifiée par le paramètre de chaîne .

Remarques

La première ligne de la chaîne a un décalage de 0. Vous pouvez affecter plusieurs lignes à une chaîne en incorporant les caractères\n ou \r\n dans la chaîne. En outre, vous pouvez utiliser le signe à l’adresse (@) immédiatement avant le guillemet ouvrant et utiliser la touche Entrée pour répartir des parties de la valeur de chaîne sur plusieurs lignes dans l’éditeur de code X++.

Example

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);            

strLTrim

Supprime les espaces de début d’une chaîne de texte.

str strLTrim(str text)

Paramètres

Valeur retournée

Chaîne équivalente pour le texte dont les espaces de début ont été supprimés.

Remarques

La fonction strLTrim est complémentaire à la fonction strRTrim .

Example

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

strLwr

Convertit toutes les lettres de la chaîne spécifiée en minuscules.

str strLwr(str _text)

Paramètres

Valeur retournée

Copie de la chaîne spécifiée qui contient uniquement une lettre minuscule.

Remarques

La fonction strLwr est complémentaire à la fonction strUpr . La fonction strLwr utilise la fonction LCMapString dans l’API Win32.

Example

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

Recherche une partie d’une chaîne de texte pour la première occurrence d’un caractère qui n’est pas inclus dans la liste spécifiée des caractères.

int strNFind(str _text, str _characters, int _position, int _number)

Paramètres

Valeur retournée

Position de la première occurrence d’un caractère qui n’est pas spécifié par le paramètre _characters , ou 0 lorsqu’aucun caractère n’a été trouvé.

Remarques

La recherche ne respecte pas la casse. Pour effectuer une recherche du début de la chaîne à la fin, utilisez la valeur 1 pour le paramètre _position . Si un signe moins précède la valeur du paramètre _number , les caractères sont recherchés dans l’ordre inverse, en commençant par la position spécifiée par le paramètre _position .

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

La fonction strNFind est complémentaire à la fonction strFind .

strPoke

Remplace une partie d’une chaîne avec une autre chaîne.

str strPoke(str _text1, str _text2, int _position)

Paramètres

Valeur retournée

Nouvelle chaîne.

Remarques

La nouvelle chaîne peut être plus longue que la chaîne d’origine. Toutefois, si la valeur du paramètre _position est supérieure à la longueur de la chaîne, la chaîne d’origine est retournée sans remplacement.

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

Ajoute une chaîne avec le nombre spécifié de caractères de point, suivi d’un signe deux-points et d’un caractère d’espace.

str strPrompt(str _string, _int len)

Paramètres

Valeur retournée

Chaîne qui ressemble à une invite d’entrée utilisateur.

Remarques

Dans les cas atypiques, où la valeur du paramètre _len n’est que légèrement supérieure à la longueur de la chaîne d’origine, la priorité la plus élevée est donnée pour ajouter l’espace de fin. Ensuite, la priorité est donnée au signe deux-points. La priorité la plus basse est donnée aux périodes. Les valeurs négatives du paramètre _len retournent la chaîne d’entrée ajoutée avec un espace de fin.

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

Example

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

Supprime les caractères spécifiés dans une chaîne d’une autre chaîne.

str strRem(str text1, str text2)

Paramètres

Valeur retournée

Contenu restant de la chaîne d’origine.

Remarques

Cette fonction respecte la casse.

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

Cette fonction est complémentaire à la fonction strKeep .

strRep

Répète une chaîne de caractères.

str strRep(str _text, str _number)

Paramètres

Valeur retournée

Nouvelle chaîne qui contient le contenu de la chaîne d’origine qui répète le nombre spécifié de fois.

Example

L’exemple suivant imprime la chaîne de texteBABAB.

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

Supprime les caractères d’espace de fin d’une chaîne.

str strRTrim(str _text)

Paramètres

Valeur retournée

Copie de la chaîne spécifiée qui n’inclut pas les caractères d’espace de fin.

Remarques

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

La fonction strRTrim est complémentaire à la fonction strLTrim .

strScan

Recherche une chaîne de texte pour une occurrence d’une autre chaîne.

int strScan(str _text1, str _text2, int _position, int _number)

Paramètres

Valeur retournée

Position à laquelle la chaîne spécifiée a été trouvée dans la chaîne ; sinon, 0 (zéro).

Remarques

Les comparaisons ne respectent pas la casse. Les valeurs du paramètre _position qui sont inférieures à 1 sont traitées comme 1. La direction de l’analyse est contrôlée par le signe spécifié dans le paramètre _number . Un signe positif indique que chaque comparaison successive démarre une position plus proche de la fin de la chaîne. Un signe négatif indique que chaque comparaison démarre une position plus proche du début de la chaîne.

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

Convertit toutes les lettres d’une chaîne en majuscules.

str strUpr(str _text)

Paramètres

Valeur retournée

Copie de la chaîne spécifiée qui contient uniquement des lettres minuscules.

Remarques

La fonction strUpr est complémentaire à la fonction strLwr . La fonction strUpr utilise la fonction LCMapString() dans l’API Win32.

Example

L’exemple suivant imprime ABCDD55EFGHIJ.

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

subStr

Récupère une partie d’une chaîne.

str subStr(str _text, int _position, int _number)

Paramètres

Valeur retournée

Sous-chaîne de la chaîne d’origine.

Remarques

Si un signe moins précède la valeur du paramètre _number , la sous-chaîne est sélectionnée vers l’arrière à partir de la position spécifiée.

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

Vérifie si la chaîne de texte contient une autre chaîne.

boolean strContains(str _text, str _potentialContains)

Paramètres

Valeur retournée

True si la chaîne d’origine contient la chaîne recherchée ; sinon, false.

Remarques

Les comparaisons ne respectent pas la casse.

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

Vérifie si la chaîne de texte commence par une autre chaîne.

boolean strStartsWith(str _string, str _potentialStart)

Paramètres

Valeur retournée

True si la chaîne potentielle est le début de la chaîne d’origine ; sinon, false.

Remarques

Les comparaisons ne respectent pas la casse.

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

Vérifie si la chaîne de texte se termine par une autre chaîne.

boolean strEndsWith(str _string, str _potentialEnd)

Paramètres

Valeur retournée

True si la chaîne potentielle met fin à la chaîne d’origine ; sinon, false.

Remarques

Les comparaisons ne respectent pas la casse.

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

Supprime les espaces de début et de fin d’une chaîne de texte.

str strLRTrim(str text)

Paramètres

Valeur retournée

Copie de la chaîne spécifiée qui n’inclut pas les caractères d’espace de début et de fin.

Remarques

La fonction strLRTrim est complémentaire aux fonctions strRTrim et strLTrim .

Example

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");