xp_sprintf (Transact-SQL)

Gilt für:SQL Server

Formatiert und speichert eine Folge von Zeichen und Werten im Ausgabeparameter vom Zeichenfolgendatentyp. Jedes Formatierungsargument wird dabei durch das entsprechende Argument ersetzt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

AUSGABE 'string'

Eine Varchar-Variable , die die Ausgabe empfängt.

Wenn OUTPUT diese Option angegeben ist, fügt diese Option den Wert der Variablen in den Ausgabeparameter ein.

'format'

Eine Formatzeichenzeichenfolge mit Platzhaltern für Argumentwerte , ähnlich den Werten, die von der C-Language-Funktion sprintf unterstützt werden. Derzeit wird nur das %s Formatargument unterstützt.

'Argument'

Eine Zeichenfolge, die den Wert des entsprechenden Formatarguments darstellt.

n

Ein Platzhalter, der angibt, dass maximal 50 Argumente angegeben werden können.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

xp_sprintf gibt die folgende Nachricht zurück:

The command(s) completed successfully.

Berechtigungen

Erfordert die Mitgliedschaft in der public -Rolle.