xp_sprintf (Transact-SQL)

S’applique à :SQL Server

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.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

SORTIE 'string'

Variable varchar qui reçoit la sortie.

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

'format'

Chaîne de caractères de format avec des espaces réservés pour les valeurs d’argument , semblable aux valeurs prises en charge par la fonction C-language sprintf . Actuellement, seul l’argument de %s format est pris en charge.

'argument'

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

n

Espace réservé qui indique qu’un maximum de 50 arguments peut être spécifié.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

xp_sprintf retourne le message suivant :

The command(s) completed successfully.

Autorisations

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