Strängfunktioner

Profile Query Language (PQL) erbjuder funktioner som gör det enklare att interagera med strängar. Mer information om andra PQL-funktioner finns i Profile Query Language översikten.

Gilla

Funktionen like används för att avgöra om en sträng matchar ett angivet mönster som ett booleskt värde.

Format

{STRING_1} like {STRING_2}
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}

Det uttryck som ska matchas mot den första strängen. Det finns två specialtecken som stöds för att skapa ett uttryck: % och _.

  • % används för att representera noll eller flera tecken.
  • _ används för att representera exakt ett tecken.

Exempel

Följande PQL-fråga hämtar alla städer som innehåller mönstret "es".

city like "%es%"

Börjar med

Funktionen startsWith används för att avgöra om en sträng börjar med en angiven delsträng som boolesk.

Format

{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens namn börjar med "Joe".

person.name.startsWith("Joe")

Börjar inte med

Funktionen doesNotStartWith används för att avgöra om en sträng inte börjar med en angiven delsträng som boolesk.

Format

{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens namn inte börjar med "Joe".

person.name.doesNotStartWith("Joe")

Slutar med

Funktionen endsWith används för att avgöra om en sträng avslutas med en angiven delsträng som boolesk.

Format

{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens e-postadress slutar med ".com".

person.emailAddress.endsWith(".com")

Slutar inte med

Funktionen doesNotEndWith används för att avgöra om en sträng inte avslutas med en angiven delsträng som boolesk.

Format

{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens e-postadress inte avslutas med ".com".

person.emailAddress.doesNotEndWith(".com")

Innehåller

Funktionen contains används för att avgöra om en sträng innehåller en angiven delsträng som boolesk.

Format

{STRING_1}.contains({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens e-postadress innehåller strängen "2010@gm".

person.emailAddress.contains("2010@gm")

Innehåller inte

Funktionen doesNotContain används för att avgöra om en sträng inte innehåller en angiven delsträng som boolesk.

Format

{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Den sträng som ska sökas efter i den första strängen.
{BOOLEAN}
En valfri parameter som avgör om kontrollen är skiftlägeskänslig. Som standard är detta true.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens e-postadress inte innehåller strängen "2010@gm".

person.emailAddress.doesNotContain("2010@gm")

Lika med

Funktionen equals används för att avgöra om en sträng är lika med den angivna strängen som ett booleskt värde.

Format

{STRING_1}.equals({STRING_2})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Strängen som ska jämföras med den första strängen.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens namn är "John".

person.name.equals("John")

Inte lika med

Funktionen notEqualTo används för att avgöra om en sträng inte är lika med den angivna strängen som ett booleskt värde.

Format

{STRING_1}.notEqualTo({STRING_2})
Argument
Beskrivning
{STRING_1}
Strängen som kontrollen ska utföras på.
{STRING_2}
Strängen som ska jämföras med den första strängen.

Exempel

Följande PQL-fråga avgör, med skiftlägeskänslighet, om personens namn inte är"John".

person.name.notEqualTo("John")

Matchar

Funktionen matches används för att avgöra om en sträng matchar ett visst reguljärt uttryck. Mer information om att matcha mönster i reguljära uttryck som booleska uttryck finns i det här dokumentet.

Format

{STRING_1}.matches(STRING_2})

Exempel

Följande PQL-fråga avgör, utan att vara skiftlägeskänslig, om personens namn börjar med "John".

person.name.matches("(?i)^John")
NOTE
Om du använder funktioner för reguljära uttryck som \w, måste du undvika det omvända snedstrecket. I stället för att bara skriva \w måste du inkludera ett extra omvänt snedstreck och skriva \\w.

Grupp för reguljära uttryck

Funktionen regexGroup används för att extrahera specifik information baserat på det reguljära uttrycket som anges som en sträng.

Format

{STRING}.regexGroup({EXPRESSION})

Exempel

Följande PQL-fråga används för att extrahera domännamnet från en e-postadress.

emailAddress.regexGroup("@(\\w+)", 1)
NOTE
Om du använder funktioner för reguljära uttryck som \w, måste du undvika det omvända snedstrecket. I stället för att bara skriva \w måste du inkludera ett extra omvänt snedstreck och skriva \\w.

Nästa steg

Nu när du har lärt dig om strängfunktioner kan du använda dem i dina PQL-frågor. Mer information om andra PQL-funktioner finns i Profile Query Language-översikten.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871