Tekenreeksfuncties
In dit hoofdstuk worden functies voor het werken met en manipuleren van tekenreeksen beschreven.
Alle functies kunnen zowel worden gebruikt in het load-script voor gegevens als in diagramuitdrukkingen, behalve Evaluate, dat alleen kan worden gebruikt in het load-script voor gegevens.
Gebruik de vervolgkeuzelijst bij elke functie om een korte beschrijving en de syntaxis van de functie te bekijken. Klik op de functienaam in de beschrijving van de syntaxis voor meer informatie.
De Capitalize() functie converteert het eerste teken van elk woord in een teksttekenreeks naar hoofdletters en converteert alle andere tekens naar kleine letters.
Capitalize(text)
Chr() retourneert het Unicode-teken dat overeenkomt met het ingevoerde gehele getal.
Chr(int)
CountRegEx() retourneert het aantal keren dat het opgegeven reguliere expressiepatroom voorkomt in de tekst van de invoertekenreeks. Als er geen overeenkomst wordt gevonden, wordt 0 geretourneerd.
CountRegEx(text, regex)
Evaluate() bepaalt of de tekenreeks van de invoertekst kan worden geëvalueerd als een geldige Qlik Sense-uitdrukking en retourneert, als dat inderdaad het geval is, de waarde van de uitdrukking als een tekenreeks. Als de invoertekenreeks geen geldige uitdrukking is, wordt NULL geretourneerd.
Evaluate(expression_text)
ExtractRegEx() extraheert tekst uit een tekenreeksuitdrukking met behulp van het opgegeven reguliere expressiepatroon. De functie retourneert een nulwaarde als er geen overeenkomsten worden gevonden.
ExtractRegEx(text, regex [, field_no])
ExtractRegExGroup() extraheert tekst uit een tekenreeksuitdrukking met behulp van het samengestelde reguliere expressiepatroon dat is opgegeven. Geef bij het gebruik van de functie de groep op die binnen de samengestelde regex moet worden gebruikt. De functie retourneert een nulwaarde als er geen overeenkomsten worden gevonden.
ExtractRegExGroup(text, regex, group [, field_no])
FindOneOf() doorzoekt een tekenreeks om de positie te vinden van enig teken uit de reeks van opgegeven tekens. De positie van het N-de exemplaar van een teken uit de zoekset wordt geretourneerd, waarbij N de optionele derde parameter van de functie is. Als er geen derde parameter wordt opgegeven, wordt het eerste exemplaar geretourneerd. Als geen waarde wordt gevonden, wordt 0 geretourneerd.
FindOneOf(text, char_set[, count])
Hash128() retourneert een 128-bits hashwaarde van de gecombineerde invoerwaarden van de uitdrukking. Het resultaat is een tekenreeks van 22 tekens.
Hash128(expr{, expression})
Hash160() retourneert een 160-bits hashwaarde van de gecombineerde invoerwaarden van de uitdrukking. Het resultaat is een tekenreeks van 27 tekens.
Hash160(expr{, expression})
Hash256() retourneert een 256-bits hashwaarde van de gecombineerde invoerwaarden van de uitdrukking. Het resultaat is een tekenreeks van 43 tekens.
Hash256(expr{, expression})
Index() doorzoekt een tekenreeks om de beginpositie te vinden van de n-de keer dat een opgegeven subtekenreeks voorkomt. Een optioneel derde argument levert de waarde van n, die 1 is als het argument wordt weggelaten. Bij een negatieve waarde wordt gezocht vanaf het einde van de tekenreeks. De nummering van de posities in de tekenreeks loopt van links naar rechts en begint bij 1.
Index (text, substring[, count])
IndexRegEx() doorzoekt de invoertekenreeks en geeft de startpositie van de n-de herhaling van het gespecificeerde reguliere expressiepatroon. Een optioneel derde argument count levert de waarde van n, die 1 is als het argument wordt weggelaten. De nummering van de posities in de tekenreeks loopt van links naar rechts en begint bij 1. Als er geen overeenkomst wordt gevonden, retourneert de functie 0.
IndexRegEx(text, regex [, count])
ExtractRegExGroup() extraheert tekst uit een tekenreeksuitdrukking met behulp van het samengestelde reguliere expressiepatroon dat is opgegeven. Geef bij het gebruik van de functie de groep op die binnen de samengestelde regex moet worden gebruikt. De functie retourneert een nulwaarde als er geen overeenkomsten worden gevonden.
IndexRegExGroup(text, regex, group [, count])
IsJson() controleert of een opgegeven string geldige JSON-gegevens (JavaScript Object Notation) bevat. U kunt ook een specifiek JSON-gegevenstype valideren.
IsJson(json [, type])
IsRegEx() retourneert of de opgegeven tekst een geldige reguliere expressie is.
IsRegEx(expr [, debug)
JsonGet() retourneert het pad van een JSON-gegevensreeks (JavaScript Object Notation). De JSON-gegevens moeten een geldige JSON-string zijn, maar kunnen extra spaties of nieuwe regels bevatten.
JsonGet(json, path)
JsonSet() wijzigt een string die JSON-gegevens (JavaScript Object Notation) bevat. Het kan een JSON-waarde instellen of invoegen met de nieuwe locatie die is opgegeven door het pad. De JSON-gegevens moeten een geldige JSON zijn, maar kunnen extra spaties of nieuwe regels bevatten.
JsonSet(json, path, value)
KeepChar() retourneert een tekenreeks die bestaat uit tekens van de eerste rekenreeks die overeenkomen met de tekens in de tweede tekensreeks. Deze functie is hoofdlettergevoelig.
KeepChar(text, keep_chars)
Left() retourneert een tekenreeks die bestaat uit de eerste (meest linker) van de invoertekenreeks, waarbij het aantal tekens wordt bepaald door het tweede argument.
Left(text, count)
Len() retourneert de lengte van de invoertekenreeks.
Len(text)
LevenshteinDist() retourneert de afstand van Levenshtein tussen twee tekenreeksen. Het wordt gedefinieerd als het aantal bewerkingen van één teken (invoegingen, verwijderingen of vervangingen) dat is vereist om een tekenreeks te wijzigen. De functie kan worden gebruikt om fuzzy tekenreeksen te vergelijken.
LevenshteinDist(text1, text2)
Lower() converteert alle tekens in de invoertekenreeks naar kleine letters.
Lower(text)
LTrim() retourneert de invoertekenreeks, ontdaan van beginspaties.
LTrim(text)
MatchRegEx() vergelijkt de invoertekenreeks met een of meer gespecificeerde reguliere expressiepatronen en retourneert de numerieke locatie van de overeenkomende reguliere expressiepatronen. Als er geen overeenkomsten worden gevonden, retourneert de functie 0. Deze functie zoekt alleen naar exacte overeenkomsten.
MatchRegEx(text, regex1 [ , regex2,...regexN])
Mid() retourneert het gedeelte van de invoertekenreeks dat begint op de positie van het teken dat is gedefinieerd door het tweede argument, 'start', en retourneert het aantal tekens dat is gedefinieerd door het derde argument, 'count'. Als 'count' wordt weggelaten, wordt de rest van de invoertekenreeks geretourneerd. Het eerste teken in de invoertekenreeks heeft het nummer 1.
Mid(text, start[, count])
Ord() returneert de numerieke (ASCII of Unicode) waarde van het eerste teken van een tekenreeks. Deze functie is handig om tekenreeksen te evalueren of te vergelijken op basis van hun onderliggende tekencodes, bijvoorbeeld bij het sorteren of filteren van tekenreeksen met niet-standaard tekens.
Ord(text)
PurgeChar() retourneert een tekenreeks die bestaat uit de tekens die zijn opgenomen in de invoertekenreeks ('text'), behalve de tekens die voorkomen in het tweede argument ('remove_chars').
PurgeChar(text, remove_chars)
Repeat() vormt een tekenreeks die bestaat uit de invoertekenreeks die het aantal keren wordt herhaald dat wordt gedefinieerd door het tweede argument.
Repeat(text[, repeat_count])
Replace() retourneert een tekenreeks nadat alle treffers van een bepaalde subtekenreeks in de tekenreeks zijn vervangen door een andere subtekenreeks. De functie is niet-recursief en wordt van links naar rechts uitgevoerd.
Replace(text, from_str, to_str)
ReplaceRegEx() retourneert een tekenreeks na het vervangen van één of meer overeenkomsten tussen een invoertekenreeks en een gespecificeerd regulier expressiepatroon. De tekst die de overeenkomende tekst vervangt, wordt opgegeven in het argument to_str. De functie wordt van links naar rechts uitgevoerd, maar als u een negatieve occurrence waarde opgeeft, leest de functie van rechts naar links.
ReplaceRegEx(text, regex, to_str [, occurrence])
ReplaceRegExGroup() retourneert een tekenreeks na het vervangen van één of meer overeenkomsten tussen een invoertekenreeks en het samengestelde reguliere expressiepatroon dat is opgegeven. De tekst die de overeenkomende tekst vervangt, wordt opgegeven in het argument to_str. De functie wordt van links naar rechts uitgevoerd, maar als u een negatieve occurrence waarde opgeeft, leest de functie van rechts naar links.
ReplaceRegExGroup(text, regex, to_str, group [, occurrence])
Right() retourneert een tekenreeks die bestaat uit de laatste tekens (meest rechts) van de invoertekenreeks, waarbij het aantal tekens wordt bepaald door het tweede argument.
Right(text, count)
RTrim() retourneert de invoertekenreeks, ontdaan van eindspaties.
RTrim(text)
Subfield() wordt gebruikt voor het extraheren van onderdelen van subtekenreeksen van een bovenliggend tekenreeksveld, waarbij de oorspronkelijke recordvelden bestaat uit twee of meer onderdelen met een scheidingsteken ertussen.
SubField(text, delimiter[, field_no ])
SubFieldRegEx() extraheert tekst uit een tekenreeksuitdrukking en gebruikt het opgegeven reguliere expressiepatroon als scheidingsteken. De functie retourneert een nulwaarde als er geen overeenkomsten worden gevonden.
SubFieldRegEx(text, regex_delimiter [, field_no])
SubstringCount() retourneert het aantal keren dat de opgegeven subtekenreeks voorkomt in de tekst van de invoertekenreeks. Als er geen overeenkomst wordt gevonden, wordt 0 geretourneerd.
SubStringCount(text, substring)
TextBetween() retourneert de tekst in de invoertekenreeks die tussen de tekens staat die zijn opgegeven als scheidingstekens.
TextBetween(text, delimiter1, delimiter2[, n])
Trim() retourneert de invoertekenreeks, ontdaan van alle begin- en eindspaties.
Trim(text)
Upper() converteert alle tekens in de invoertekenreeks naar hoofdletters voor alle teksttekens in de uitdrukking. Cijfers en symbolen worden genegeerd.
Upper(text)