Fonction RSTRING( )

Renvoie une valeur de chaîne de caractères calculée par un script ou une fonction R. Le traitement des données dans Rvachev est externe à Analytics.

Syntaxe

RSTRING(rScript|rCode; longueur <;champ|valeur <;...n>>)

Paramètres

Nom	Type	Description
rScript \| rCode	caractère	Le chemin d'accès complet ou relatif au script R ou à un snippet de code R à exécuter. Si vous saisissez le code R directement plutôt que d'utiliser un fichier externe, vous ne pouvez pas utiliser le caractère de guillemet fermant, même si vous l'échappez : valide 'var <- "\"test\"" ' non valide 'var <- "\'test\'" '
longueur	numérique	La longueur à allouer pour la chaîne de retour.
champ \| valeur <;...n> optionnel	caractère numérique DateHeure logique	La liste des champs, des expressions ou des valeurs littérales à utiliser comme arguments pour le snippet de code ou le script R. Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les indiquez, puis vous y référez à l'aide de valeur1; valeur2 ... valeurN dans le code R. Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le code R. Remarque La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la rubrique Fonction ALLTRIM( ).

Nom

Type

Description

rScript | rCode

caractère

Le chemin d'accès complet ou relatif au script R ou à un snippet de code R à exécuter.

Si vous saisissez le code R directement plutôt que d'utiliser un fichier externe, vous ne pouvez pas utiliser le caractère de guillemet fermant, même si vous l'échappez :

valide 'var <- "\"test\"" '
non valide 'var <- "\'test\'" '

longueur

numérique

La longueur à allouer pour la chaîne de retour.

champ | valeur <;...n>

optionnel

caractère

numérique

DateHeure

logique

La liste des champs, des expressions ou des valeurs littérales à utiliser comme arguments pour le snippet de code ou le script R.

Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les indiquez, puis vous y référez à l'aide de valeur1; valeur2 ... valeurN dans le code R.

Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le code R.

Remarque

La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la rubrique Fonction ALLTRIM( ).

Sortie

Caractère.

Exemples

Exemples de base

Renvoie "abc123" :

RSTRING("print(paste(valeur1;valeur2;sep=""))";6;"abc";"123")

Exemples avancés

Utilisation d'un script R externe

Concatène x et y dans une seule chaîne délimitée par un caractère espace :

RSTRING("a<-source('./sample.r');a[[1]]"; 50; Prénom; Nom)

Script R externe (sample.r) :

conc <- function(x, y) {
    paste(x, y, sep=" ")
}
print(conc(value1, value2))

Utilisation du code R stocké dans une variable

Concatène x et y dans une seule chaîne délimitée par un caractère espace :

ASSIGN v_script = "conc <- function(x, y){paste(x, y, sep=' ')};conc(value1, value2)"
RSTRING(v_script; 50; Prénom; Nom)

Utilisation de R pour générer un UUID pour une table

Vous préparez une table d'exceptions à charger dans Résultats et il vous faut un identifiant unique garanti pour chaque enregistrement. Pour générer ce champ, vous utilisez le package uuid dans R afin de créer une valeur de clé primaire unique pour chaque enregistrement :

EXTRACT RSTRING("uuid::UUIDgenerate()"; 36) AS "id"; prénom; nom; date_anniversaire TO table_exportation

Astuce

Pour installer le package uuid, ouvrez R.exe et exécutez la commande suivante :

install.packages("uuid")

Remarques

Renvoi de données à partir de R

Lorsque vous appelez des scripts R, utilisez la fonction source et affectez l'objet renvoyé à une variable. Vous pouvez alors accéder à la valeur renvoyée depuis votre fonction R à partir de l'objet renvoyé :

# 'a' contient l'objet de réponse et a[[1]] accède à la valeur des données
"a<-source('c:\\scripts\\r_scripts\\sample.r');a[[1]]"

Fichier trace R

Analytics enregistre les messages en langage R dans un fichier aclrlang.log dans le dossier de projet. Utilisez ce fichier trace pour le débogage des erreurs R