Share via

  • Artikel

xp_sprintf (Transact-SQL)

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

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • string
    Eine varchar-Variable für die Ausgabe.

  • OUTPUT
    Wenn dieser Parameter angegeben wird, wird der Wert der Variablen in den Ausgabeparameter gesetzt.

  • format
    Eine Formatierungszeichenfolge mit Platzhaltern für argument-Werte, ähnlich wie bei der sprintf-Funktion der Programmiersprache C. Derzeit wird nur das %s-Formatierungsargument unterstützt.

  • argument
    Eine Zeichenfolge, die den Wert des entsprechenden Formatierungsarguments darstellt.

  • n
    Ein Platzhalter, der anzeigt, dass bis zu 50 Argumente angegeben werden können.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

xp_sprintf gibt die folgende Nachricht zurück:

The command(s) completed successfully.

Berechtigungen

Erfordert die Mitgliedschaft in der public-Rolle.