Kategorien:

Zeichenfolgen- und Binärfunktionen (Allgemein)

RPAD

Füllt eine Zeichenfolge rechts mit Zeichen aus einer anderen Zeichenfolge auf oder füllt einen Binärwert rechts mit Bytes aus einem anderen Binärwert auf.

Das Argument (base) wird mit Zeichen/Bytes aus dem Argument length_expr auf die Länge pad aufgefüllt.

Syntax

RPAD(<base>, <length_expr> [, <pad>])
Copy

Argumente

base

Dies muss ein VARCHAR- oder BINARY-Wert sein.

length_expr

Die Länge muss ein Ausdruck sein, der zu einer Ganzzahl ausgewertet wird. Es muss angeben:

  • Die Anzahl der zurückzugebenden UTF-8 Zeichen, wenn die Eingabe VARCHAR lautet.

  • Die Anzahl der zurückzugebenden Bytes, wenn die Eingabe BINARY ist.

pad

Dies muss ein VARCHAR- oder BINARY-Wert sein. Der Typ muss mit dem Datentyp des Parameters base übereinstimmen. Zeichen (oder Bytes) aus diesem Parameter werden zum Auffüllen der base verwendet.

Rückgabewerte

Der Datentyp des zurückgegebenen Wertes entspricht dem Datentyp des Eingabewerts base (BINARY oder VARCHAR).

Nutzungshinweise

  • Wenn das base-Argument länger als length_expr ist, wird es auf die Länge length_expr gekürzt.

  • Das pad-Argument kann mehrere Zeichen/Bytes lang sein. Das pad-Argument wird im Ergebnis wiederholt, bis die gewünschte Länge length_expr erreicht ist. Alle überflüssigen Zeichen/Bytes im pad-Argument werden abgeschnitten. Wenn das pad-Argument leer ist, werden keine Zeichen zum Auffüllen eingefügt. Das Ergebnis wird jedoch trotzdem auf die Länge length_expr gekürzt.

  • Wenn base eine Zeichenfolge ist, ist die standardmäßige pad-Zeichenfolge „ “ (ein einzelnes Leerzeichen). Wenn base ein Binärwert ist, muss das pad-Argument explizit angegeben werden.

Sortierungsdetails

  • Sortierung gilt für VARCHAR-Eingaben. Sortierung gilt nicht, wenn der Eingabedatentyp des ersten Parameters BINARY ist.

  • No impact. Obwohl Sortierungen syntaktisch akzeptiert werden, haben sie keine Auswirkungen auf die Verarbeitung. Beispielsweise zählen Sprachen mit zwei- und dreistelligen Buchstaben (z. B. „dzs“ im Ungarischen, „ch“ im Tschechischen) weiterhin zwei oder drei Zeichen (nicht ein Zeichen) für das Längenargument.

  • The collation of the result is the same as the collation of the input. Dies kann nützlich sein, wenn der zurückgegebene Wert als Teil verschachtelter Funktionsaufrufe an eine andere Funktion übergeben wird.

  • Derzeit können die base- und pad-Argumente in Snowflake unterschiedliche Sortierungsspezifizierer haben. Die einzelnen Sortierungsspezifizierer können jedoch nicht beide beibehalten werden, da der zurückgegebene Wert nur einen Sortierungsspezifizierer enthält. Snowflake empfiehlt Benutzern, die Verwendung von pad-Zeichenfolgen zu vermeiden, deren Sortierung von der base-Zeichenfolge abweicht.

Beispiele

SELECT RPAD('123.50', 20, '*-') FROM dual;

--------------------------+
 RPAD('123.50', 20, '*-') |
--------------------------+
 123.50*-*-*-*-*-*-*-     |
--------------------------+
Copy