Teilen über


SUBSTRING (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt einen Teil eines Zeichenfolgenausdrucks zurück, der an der angegebenen Position beginnt und die angegebene Länge hat bzw. bis zum Ende der Zeichenfolge geht.

Syntax

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)  

Argumente

BESCHREIBUNG
string_expr Ein Zeichenfolgenausdruck.
numeric_expr_1 Ein numerischer Ausdruck zur Angabe des Startzeichens.
numeric_expr_2 Ein numerischer Ausdruck, der die maximale Anzahl von Zeichen angibt, die von string_expr zurückgegeben werden sollen.

Rückgabetypen

Gibt einen Zeichenfolgenausdruck zurück.

Beispiele

Im folgenden Beispiel werden Teilzeichenfolgen mit verschiedenen Längen und Startpositionen zurückgegeben.

SELECT VALUE {
    substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
    substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
    substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
    substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}
[
  {
    "substringPrefix": "Adventure",
    "substringSuffix": "Works",
    "substringTotalLength": "AdventureWorks",
    "substringEmptyString": ""
  }
]

Bemerkungen

  • Diese Funktion profitiert von einem Bereichsindex, wenn die Startposition 0 ist.
  • numeric_expr_1-Positionen sind nullbasiert, daher beginnt der Wert 0 beim ersten Zeichen von string_expr.
  • 0 oder ein geringerer Wert für numeric_expr_2 ergibt eine leere Zeichenfolge.