Строковые функции
В этом разделе описаны функции для обработки и управления строками.
Все функции можно использовать как в скрипте загрузки данных, так и в выражениях диаграмм, кроме функции Evaluate, которую можно использовать только в скрипте загрузки данных.
Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.
Функция Capitalize() переводит первый символ каждого слова в текстовой строке в верхний регистр и переводит все остальные символы в нижний регистр.
Capitalize(text)
Функция Chr() возвращает символ Unicode, соответствующий входному целому числу, также называемый кодовой точкой.
Chr(int)
CountRegEx() возвращает количество вхождений указанного шаблона регулярного выражения в тексте входной строки. Если совпадения отсутствуют, возвращается 0.
CountRegEx(text, regex)
Evaluate() определяет, можно ли входную текстовую строку рассматривать в качестве допустимого выражения Qlik Sense. Если да, то возвращает значение выражения в качестве строки. Если входная строка не является допустимым выражением, будет возвращено значение NULL.
Evaluate(expression_text)
ExtractRegEx() извлекает текст из входного строкового выражения, используя указанный шаблон регулярного выражения. Функция возвращает нулевое значение, если не найдено ни одного совпадения.
ExtractRegEx(text, regex [, field_no])
ExtractRegExGroup() извлекает текст из входного строкового выражения, используя указанный шаблон составного регулярного выражения. При использовании функции укажите группу, которую следует использовать в составном регулярном выражении. Функция возвращает нулевое значение, если не найдено ни одного совпадения.
ExtractRegExGroup(text, regex, group [, field_no])
FindOneOf() выполняет поиск в строке, чтобы найти положение вхождения любого символа из набора указанных символов. Возвращается позиция N-го появления любого символа из поискового набора, где N ― необязательный третий параметр функции. Если третий параметр не указан, то возвращается первое вхождение. Если совпадений не найдено, возвращается значение 0.
FindOneOf(text, char_set[, count])
Hash128() возвращает 128-разрядное значение хэша для сочетания значений входного выражения. Результат — строка из 22 символов.
Hash128(expr{, expression})
Hash160() возвращает 160-разрядное значение хэша для сочетания значений входного выражения. Результат — строка из 27 символов.
Hash160(expr{, expression})
Hash256() возвращает 256-разрядное значение хэша для сочетания значений входного выражения. Результат — строка из 43 символов.
Hash256(expr{, expression})
Index() выполняет поиск в строке, чтобы найти n-ное положение вхождения указанной подстроки. Дополнительный третий аргумент определяет значение n (1, если игнорируется). Если указано отрицательное значение, поиск выполняется с конца строки. Позиции в строке нумеруются слева направо от 1 и далее.
Index (text, substring[, count])
IndexRegEx() выполняет поиск во входной строке и возвращает начальную позицию n-го вхождения указанного шаблона регулярного выражения. Дополнительный третий аргумент count определяет значение n (1, если опущен). Позиции в строке нумеруются слева направо от 1 и далее. Если совпадение не найдено, функция возвращает 0.
IndexRegEx(text, regex [, count])
ExtractRegExGroup() извлекает текст из входного строкового выражения, используя указанный шаблон составного регулярного выражения. При использовании функции укажите группу, которую следует использовать в составном регулярном выражении. Функция возвращает нулевое значение, если не найдено ни одного совпадения.
IndexRegExGroup(text, regex, group [, count])
IsJson() проверяет, содержит ли указанная строка допустимые данные JSON (JavaScript Object Notation). Также можно проверить конкретный тип данных JSON.
IsJson(json [, type])
IsRegEx() возвращает ответ на вопрос, является ли указанный текст правильным регулярным выражением.
IsRegEx(expr [, debug)
JsonGet() возвращает путь к строке данных JSON (JavaScript Object Notation). Данные должны быть допустимым кодом JSON, но могут содержать дополнительные пробелы и символы новой строки.
JsonGet(json, path)
JsonSet() изменяет строку, содержащую данные JSON (JavaScript Object Notation). Может задать или вставить значение JSON с указанием нового местоположения в пути. Данные должны быть допустимым кодом JSON, но могут содержать дополнительные пробелы и символы новой строки.
JsonSet(json, path, value)
KeepChar() возвращает строку, состоящую из символов в первой строке, которые соответствуют символам во второй строке. Эта функция чувствительна к регистру.
KeepChar(text, keep_chars)
Left() возвращает строку, состоящую из первых (крайних слева) символов входной строки, где число символов определяется вторым аргументом.
Left(text, count)
Len() возвращает длину входной строки.
Len(text)
LevenshteinDist() возвращает расстояние Levenshtein — разность между двумя строками. Оно определяется как минимальное количество односимвольных правок (вставки, удаления или замены), требуемых для превращения одной строки в другую. Функция полезна для нечеткого сравнения строк.
LevenshteinDist(text1, text2)
Lower() преобразует все символы входной строки в нижний регистр.
Lower(text)
LTrim() возвращает входную строку без начальных пробелов.
LTrim(text)
MatchRegEx() сравнивает входную строку с одним или несколькими заданными шаблонами регулярных выражений и возвращает числовой индекс местоположения совпадающих шаблонов регулярных выражений. Если совпадений не найдено, функция возвращает 0. Эта функция ищет только точные совпадения.
MatchRegEx(text, regex1 [ , regex2,...regexN])
Mid() возвращает часть входной строки, начинающуюся с символа, определенного вторым аргументом «start», и возвращает количество символов, определенных третьим аргументом «count». Если «count» отсутствует, возвращается остальная часть входной строки. Первый символ во входной строке имеет номер 1.
Mid(text, start[, count])
Ord() возвращает числовое значение (ASCII или Unicode) первого символа строки. Эта функция полезна для оценки или сравнения строк на основе их базовых кодов символов, например, при сортировке или фильтрации строк с нестандартными символами.
Ord(text)
PurgeChar() возвращает строку, состоящую из всех символов входной строки («text»), кроме символов, указанных в строке второго аргумента («remove_chars»).
PurgeChar(text, remove_chars)
Repeat() возвращает строку, состоящую из входной строки, повторяющейся столько раз, сколько указано вторым аргументом.
Repeat(text[, repeat_count])
Replace() возвращает строку после замены всех вхождений определенной подстроки во входной строке на другую подстроку. Функция нерекурсивная и работает слева направо.
Replace(text, from_str, to_str)
ReplaceRegEx() возвращает строку после замены одного или нескольких совпадений между входной строкой и заданным шаблоном регулярного выражения. Текст, который заменяет совпадающий текст, указан в аргументе to_str. Функция работает слева направо, но если задано отрицательное значение occurrence, функция читает справа налево.
ReplaceRegEx(text, regex, to_str [, occurrence])
ReplaceRegExGroup() возвращает строку после замены одного или нескольких совпадений между входной строкой и заданным шаблоном составного регулярного выражения. Текст, который заменяет совпадающий текст, указан в аргументе to_str. Функция работает слева направо, но если задано отрицательное значение occurrence, функция читает справа налево.
ReplaceRegExGroup(text, regex, to_str, group [, occurrence])
Right() возвращает строку, состоящую из последних символов (справа) входной строки, где число символов определяется вторым аргументом.
Right(text, count)
RTrim() возвращает входную строку без конечных пробелов.
RTrim(text)
SubField() используется для извлечения компонентов подстроки из поля родительской строки, где поля исходной записи состоят из двух или более частей, разделенных знаком разделителя.
SubField(text, delimiter[, field_no ])
SubFieldRegEx() извлекает текст из входного строкового выражения, используя указанный шаблон регулярного выражения в качестве разделителя. Функция возвращает нулевое значение, если не найдено ни одного совпадения.
SubFieldRegEx(text, regex_delimiter [, field_no])
SubStringCount() возвращает количество вхождений указанной подстроки в тексте входной строки. Если совпадения отсутствуют, возвращается 0.
SubStringCount(text, substring)
TextBetween() возвращает текст входной строки, заключенный между символами, указанными в качестве разделителей.
TextBetween(text, delimiter1, delimiter2[, n])
Trim() возвращает входную строку без начальных и конечных пробелов.
Trim(text)
Upper() преобразует все символы входной строки в верхний регистр для всех буквенных символов в выражении. Цифры и символы игнорируются.
Upper(text)