förhandsversion av REGEXP_INSTR (Transact-SQL)

Gäller för: SQL Server 2025 (17.x) Förhandsversion av Azure SQL DatabaseAzure SQL Managed InstanceSQL Database i Förhandsversion av Microsoft Fabric

Returnerar start- eller slutpositionen för den matchade delsträngen, beroende på värdet för argumentet return_option.

REGEXP_INSTR
     (
      string_expression,
      pattern_expression
         [, start [, occurrence [, return_option [, flags [, group ] ] ] ] ]
     )

Arguments

string_expression

Ett uttryck för en teckensträng.

Kan vara en konstant, variabel eller kolumn med teckensträng.

Datatyper: char, nchar, varchareller nvarchar.

pattern_expression

Mönster för reguljära uttryck som ska matchas. Vanligtvis en textliteral.

Datatyper: char, nchar, varchareller nvarchar. pattern_expression stöder en maximal teckenlängd på 8 000 byte.

start

Anger startpositionen för sökningen i söksträngen. Optional. Typen är int eller bigint.

Numreringen är 1-baserad, vilket innebär att det första tecknet i uttrycket är 1 och värdet måste vara >= 1. Om startuttrycket är mindre än 1returneras felet. Om startuttrycket är större än längden på string_expression returnerar 0funktionen . Standardvärdet är 1.

occurrence

Ett uttryck (positivt heltal) som anger vilken förekomst av mönsteruttrycket i källsträngen som ska sökas eller ersättas. Standardvärdet är 1. Söker efter det första tecknet i string_expression. För ett positivt heltal nsöker nth den efter förekomsten som börjar med det första tecknet efter den första förekomsten av pattern_expression och så vidare.

return_option

Anger om du vill returnera början eller slutpositionen för den matchade delsträngen. Använd 0 för början och 1 för slutet. Standardvärdet är 0. Frågan returnerar fel för andra värden.

flag

Ett eller flera tecken som anger de modifierare som används för att söka efter matchningar. Typen är varchar eller tecken, med högst 30 tecken.

Till exempel ims. Standardvärdet är c. Om en tom sträng (' ') anges behandlas den som standardvärdet ('c'). Ange c eller andra teckenuttryck. Om flaggan innehåller flera motstridiga tecken använder SQL Server det sista tecknet.

Om du till exempel anger ic returnerar regex skiftlägeskänslig matchning.

Om värdet innehåller ett annat tecken än de som anges i flagga som stödsreturnerar frågan ett fel som liknar följande exempel:

Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.

Flaggvärden som stöds

group

Anger vilken avbildningsgrupp (subexpression) för en pattern_expression avgör positionen inom string_expression som ska returneras. Gruppen är ett fragment av mönster som omges av parenteser och kan kapslas. Grupperna numreras i den ordning som deras vänstra parenteser visas i mönster. Värdet är ett heltal och måste vara >= 0 och får inte vara större än antalet grupper i pattern_expression. Standardvärdet är 0, vilket anger att positionen baseras på strängen som matchar hela pattern_expression.

Om värdet är större än antalet grupper i pattern_expression returnerar 0funktionen .

Returvärde

Integer.

Examples

Hitta positionen för den första delsträngen som endast innehåller siffror i kolumnen PRODUCT_DESCRIPTION.

SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, '\d+')
FROM PRODUCTS;

Hitta positionen för den tredje förekomsten av bokstaven a (skiftlägesokänslig) i kolumnen PRODUCT_NAME.

SELECT REGEXP_INSTR(PRODUCT_NAME, 'a', 1, 3, 0, 'i')
FROM PRODUCTS;

Hitta positionen för slutet av den första delsträngen som börjar med t och slutar med e (skiftlägeskänslig) i kolumnen PRODUCT_DESCRIPTION.

SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, 't.*?e', 1, 1, 1)
FROM PRODUCTS;

Relaterat innehåll

• Förhandsversion av reguljära uttryck
• Funktioner för reguljära uttryck (Transact-SQL)