• Article

xp_sprintf (Transact-SQL)

Formate et stocke une série de caractères et de valeurs dans le paramètre de sortie de type chaîne. Chaque argument de format est remplacé par l'argument correspondant.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

xp_sprintf { string OUTPUT , format }
     [ , argument [ ,...n ] ]

Arguments

  • string
    Variable de type varchar qui reçoit les données en sortie.

  • OUTPUT
    Lorsqu'elle est spécifiée, cette option place la valeur de la variable dans le paramètre de sortie.

  • format
    Chaîne de format dotée d'emplacements réservés pour les valeurs de argument, à l'instar de celle prise en charge par la fonction sprintf du langage C. Pour l'instant, seul l'argument de format %s est pris en charge.

  • argument
    Chaîne de caractères qui représente la valeur de l'argument de format correspondant.

  • n
    Emplacement réservé signalant qu'un nombre maximal de 50 arguments peut être spécifié.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

xp_sprintf retourne ce message :

The command(s) completed successfully.

Autorisations

Nécessite l'appartenance au rôle public.