Fonctions XPath/XQuery : Chaîne
Les fonctions d'extension de chaîne d'Altova peuvent être utilisées dans les expressions XPath et XQuery et proposent des fonctions supplémentaires pour le traitement des données.
Note concernant le nommage de fonctions et de l'applicabilité de la langue
Les fonctions d'extension Altova peuvent être utilisées dans les expressions XPath/XQuery. Elles fournissent des fonctions supplémentaires aux fonctions d'ores et déjà disponibles dans la librairie standard des fonctions XPath, XQuery et XSLT. •Afin de distinguer les fonctions d'extension Altova des fonctions dans la librairie standard, les fonctions d'extension Altova sont nommées dans cette documentation avec un suffixe [altova:]. Par exemple : add-years-to-date [altova:]. •Néanmoins, lorsque vous utilisez des fonctions d'extension Altova dans vos expressions XPath/XQuery, vous devez utiliser la fonction sans préfixe ou suffixe, comme si vous utilisiez une fonction standard XPath/XQuery. Voici un exemple d'extension Altova : add-years-to-date(xs:date("2014-01-15"), 10).
|
camel-case(InputString as xs:string) asxs:string XP3.1 XQ3.1 Retourne la chaîne d'entrée InputString en CamelCase. La chaîne est analysée en utilisant l'expression régulière '\s' (qui est un raccourci pour le caractère d'espace blanc). Le premier caractère non-espace blanc après un espace blanc ou une séquence de plusieurs espaces blancs est mis en majuscule. Le premier caractère dans la chaîne de sortie est mis en majuscule.
camel-case(InputString as xs:string, SplitChars as xs:string, IsRegex as xs:boolean) asxs:string XP3.1 XQ3.1 Convertit la chaîne d'entrée InputString en camel case en utilisant SplitChars pour déterminer le/s caractère/s qui déclenche/nt la prochaine mise en majuscule. SplitChars est utilisé en tant qu'expression régulière quand IsRegex = true(), ou en tant que caractères normaux quand IsRegex = false(). Le premier caractère dans la chaîne de sortie est mis en majuscule.
|
char(Position as xs:integer) asxs:string XP3.1 XQ3.1 Retourne une chaîne contenant le caractère à la position spécifiée par l'argument Position, dans la chaîne obtenue en convertissant la valeur de l'item contextuel en xs:string. La chaîne de résultat sera vide si aucun caractère n'existe à l'index soumis par l'argument Position.
char(InputString as xs:string, Position as xs:integer) asxs:string XP3.1 XQ3.1 Retourne une chaîne contenant la caractère à la position spécifiée par l'argument Position, dans la chaîne soumise en tant que l'argument InputString. La chaîne de résultat sera vide si aucun caractère n'existe à l'index soumis par l'argument Position.
|
create-hash-from-string(InputString as xs:string) asxs:string XP2 XQ1 XP3.1 XQ3.1 create-hash-from-string(InputString as xs:string, HashAlgo as xs:string) asxs:string XP2 XQ1 XP3.1 XQ3.1 Génère un string de hashage depuis InputString en utilisant l'algorithme de hashage spécifié par l'argument HashAlgo. Les algorithmes de hashage suivants peuvent être spécifiés (en majuscule ou en minuscule) : MD5, SHA-1, SHA-224, SHA-256, SHA-384, SHA-512. Si le deuxième argument n'est pas spécifié (voir la première signature ci-dessus), l'algorithme de hashage SHA-256 sera utilisé.
|
first-chars(X-Number as xs:integer) asxs:string XP3.1 XQ3.1 Retourne une chaîne contenant le premier X-Number des caractères de la chaîne obtenue en convertissant la valeur de l'item de contexte en xs:string.
first-chars(InputString as xs:string, X-Number as xs:integer) asxs:string XP3.1 XQ3.1 Retourne une chaîne contenant le premier X-Number des caractères de la chaîne soumise en tant que l'argument InputString.
|
format-string(InputString as xs:string, FormatSequence as item()*) asxs:string XP3.1 XQ3.1 Le string d'entrée (premier argument) contient des paramètres de position (%1, %2, etc). Chaque paramètre est remplacé par l'item de string qui est situé dans la position correspondante dans la séquence de format (soumise en tant que le second argument). Donc le premier item dans la séquence de format remplace de paramètre de positionnement %1, le second item remplace %2, etc. La fonction retourne ce string formaté qui contient les remplacements. Si aucun string n'existe pour un paramètre de positionnement, alors le paramètre de positionnement lui-même est retourné. Cela se produit lorsque l'index d'un paramètre de positionnement est supérieur au nombre d'items dans la séquence de format.
|
last-chars(X-Number as xs:integer) as xs:string XP3.1 XQ3.1 Returns a string containing the last X-Number of characters of the string obtained by converting the value of the context item to xs:string.
last-chars(InputString as xs:string, X-Number as xs:integer) as xs:string XP3.1 XQ3.1 Returns a string containing the last X-Number of characters of the string submitted as the InputString argument.
|
pad-string-left(StringToPad as xs:string, StringLength as xs:integer, PadCharacter as xs:string) as xs:string XP3.1 XQ3.1 The PadCharacter argument is a single character. It is padded to the left of the string to increase the number of characters in StringToPad so that this number equals the integer value of the StringLength argument. The StringLength argument can have any integer value (positive or negative), but padding will occur only if the value of StringLength is greater than the number of characters in StringToPad. If StringToPad. has more characters than the value of StringLength, then StringToPad is left unchanged.
|
pad-string-right(StringToPad as xs:string, StringLength as xs:integer, PadCharacter as xs:string) as xs:string XP3.1 XQ3.1 The PadCharacter argument is a single character. It is padded to the right of the string to increase the number of characters in StringToPad so that this number equals the integer value of the StringLength argument. The StringLength argument can have any integer value (positive or negative), but padding will occur only if the value of StringLength is greater than the number of characters in StringToPad. If StringToPad has more characters than the value of StringLength, then StringToPad is left unchanged.
|
repeat-string(InputString as xs:string, Repeats as xs:integer) asxs:string XP2 XQ1 XP3.1 XQ3.1 Génère une chaîne qui est composée du premier argument InputString répété Repeats nombre de fois.
|
substring-after-last(MainString as xs:string, CheckString as xs:string) as xs:string XP3.1 XQ3.1 If CheckString is found in MainString, then the substring that occurs after CheckString in MainString is returned. If CheckString is not found in MainString, then the empty string is returned. If CheckString is an empty string, then MainString is returned in its entirety. If there is more than one occurrence of CheckString in MainString, then the substring after the last occurrence of CheckString is returned.
|
substring-before-last(MainString as xs:string, CheckString as xs:string) as xs:string XP3.1 XQ3.1 If CheckString is found in MainString, then the substring that occurs before CheckString in MainString is returned. If CheckString is not found in MainString, or if CheckString is an empty string, then the empty string is returned. If there is more than one occurrence of CheckString in MainString, then the substring before the last occurrence of CheckString is returned.
|
substring-pos(StringToCheck as xs:string, StringToFind as xs:string) as xs:integer XP3.1 XQ3.1 Returns the character position of the first occurrence of StringToFind in the string StringToCheck. The character position is returned as an integer. The first character of StringToCheck has the position 1. If StringToFind does not occur within StringToCheck, the integer 0 is returned. To check for the second or a later occurrence of StringToCheck, use the next signature of this function.
substring-pos(StringToCheck as xs:string, StringToFind as xs:string, Integer as xs:integer) as xs:integer XP3.1 XQ3.1 Returns the character position of StringToFind in the string, StringToCheck. The search for StringToFind starts from the character position given by the Integer argument; the character substring before this position is not searched. The returned integer, however, is the position of the found string within the entire string, StringToCheck. This signature is useful for finding the second or a later position of a string that occurs multiple times with the StringToCheck. If StringToFind does not occur within StringToCheck, the integer 0 is returned.
|
trim-string(InputString as xs:string) as xs:string XP3.1 XQ3.1 This function takes an xs:string argument, removes any leading and trailing whitespace, and returns a "trimmed" xs:string.
|
trim-string-left(InputString as xs:string) as xs:string XP3.1 XQ3.1 This function takes an xs:string argument, removes any leading whitespace, and returns a left-trimmed xs:string.
|
trim-string-right(InputString as xs:string) as xs:string XP3.1 XQ3.1 This function takes an xs:string argument, removes any trailing whitespace, and returns a right-trimmed xs:string.
|