Freigeben über


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

Wichtig

Argumente für erweiterte gespeicherte Prozeduren müssen in der spezifischen Reihenfolge eingegeben werden, wie im Abschnitt Syntax beschrieben. Wenn die Parameter außerhalb der Reihenfolge eingegeben werden, tritt eine Fehlermeldung auf.

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 (erfolgreich) 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.