Macro STRING_HEAD

Le STRING_HEAD est disponible uniquement dans Unica Campaign.

Syntaxe

STRING_HEAD(num_chars, data)

Paramètres

num_chars

Nombre de caractères à renvoyer à partir du début de chaque chaîne de data. Il doit s'agir d'un entier positif supérieur à zéro.

data

Valeurs de chaîne de texte ASCII. Il peut s'agir de texte ASCII entre guillemets, d'une colonne de texte, d'une plage de cibles contenant du texte ou d'une expression convertie comme l'une de ces valeurs. Pour la définition du format de data, voir la section "Paramètres des fonctions macro" du chapitre du présent document correspondant à votre produit .

Description

STRING_HEAD renvoie les num_chars premiers caractères de chaque valeur de chaîne de la plage de données spécifiée. Si num_chars est supérieur au nombre de caractères d'une chaîne de texte, les caractères restants sont remplacés par le caractère null " \0 ".

Exemples

TEMP = STRING_HEAD(3, "JAN 15, 1997")

Crée une colonne nommée TEMP, qui contient la chaîne de texte ASCII " JAN ".

TEMP = STRING_HEAD(10, "Pressure")

Crée une colonne nommée TEMP, qui contient la chaîne de texte ASCII " Pressure ".

TEMP = STRING_HEAD(5, V1)

Crée une colonne nommée TEMP contenant les cinq premiers caractères de chaque chaîne de la colonne V1.

TEMP = STRING_HEAD(1, V1:V3)

Crée trois colonnes nommées TEMP, VX et VY. Les valeurs de la colonne TEMP correspondent aux premiers caractères des chaines des lignes correspondantes de la colonne V1, les valeurs de la colonne VX correspondent aux premiers caractères des chaines des lignes correspondantes de la colonne V2 et les valeurs de la colonne VY correspondent aux premiers caractères des chaines des lignes correspondantes de la colonne V3.

TEMP = STRING_HEAD(12, V4[1:50]:V6]

Crée trois colonnes nommées TEMP, VX et VY. Les valeurs de la colonne TEMP correspondent aux 12 premiers caractères des chaines des lignes 1 à 50 de la colonne V1, les valeurs de la colonne VX correspondent aux 12 premiers caractères des chaines des lignes 1 à 50 de la colonne V2 et les valeurs de la colonne VY correspondent aux 12 premiers caractères des chaines des lignes 1 à 50 de la colonne V3.

Fonctions associées

Fonction Description
STRING_CONCAT Concatène deux chaînes de texte des plages de données spécifiées
STRING_LENGTH Renvoie la longueur de chaque chaîne de la plage de données spécifiée
STRING_SEG Renvoie le segment de chaîne entre deux index spécifiés
STRING_TAIL Renvoie les n derniers caractères de chaque chaîne de la plage de données spécifiée