Функции строки Omnistudio

Вы находитесь здесь:

Функции строки Omnistudio

Функции, оперирующие строками.

Функция Omnistudio BASE64ENCODE
Кодирует значение ввода в формате Base64.
Функция Omnistudio CONCAT
Объединяет две или более строки в одну строку.
Функция JOIN Omnistudio
Соединяет две или более строки в одну строку, разделяя каждую строку указанным маркером.
Функция Omnistudio MAXSTRING
Данная функция возвращает строку, расположенную последней лексикографически в списке двух или более строк.
Функция Omnistudio SPLIT
Разделяет строку на подстроки в каждой позиции указанного маркера.
Функция Omnistudio STRINGINDEXOF
Возвращает начальный индекс подстроки в строке.
Функция ПОДСТРОКИ Omnistudio
Возвращает подстроку строки на основе указанных начальных и конечных индексов.
Функция ТОСТРИНГ Omnistudio
Преобразует вводные данные в строку.

Функция Omnistudio BASE64ENCODE

Кодирует значение ввода в формате Base64.

Base64 - это распространенная кодировка на основе ASCII. В зашифрованном результате конечные символы = отстают.

Подпись

BASE64ENCODE(data)

Значение возврата

Строка

Параметры

Параметр	Тип данных	Необходимость	Описание
`data`	Любой тип данных	Обязательно	Значение ввода для кодирования в формате Base64. Функция не принимает нулевое значение или пустую строку.

Пример кодировки строк

Формула: BASE64ENCODE("Encode this string.")

Значение возврата: "RW5jb2RlIHRoaXMgc3RyaW5nLg=="

Пример кодировки даты

Формула: BASE64ENCODE("2003-02-01T16:35:30-0500")

Значение возврата: "MjAwMy0wMi0wMVQxNjozNTozMC0wNTAw"

Пример кодировки чисел

Формула: BASE64ENCODE(1024)

Значение возврата: "MTAyNA=="

Пример кодировки объекта JSON

Примеры данных:

"Contact": {
  "FirstName": "Thomas",
  "MiddleName": "Alva",
  "LastName": "Edison"
}

Формула: BASE64ENCODE(Contact)

Значение возврата: "e0xhc3ROYW1lPUVkaXNvbiwgTWlkZGxlTmFtZT1BbHZhLCBGaXJzdE5hbWU9VGhvbWFzfQ=="

Функция Omnistudio CONCAT

Объединяет две или более строки в одну строку.

Подпись

CONCAT(string...)

Значение возврата

Строка

Параметры

Параметр	Тип данных	Необходимость	Описание
`string...`	Строка	Обязательное	Разделенный запятыми список одной или нескольких строк для конкатенации в одну строку. Чтобы разделить строки ввода в результате, добавьте строку разделителя (например, `" "`) между каждой парой строк. Можно конкатенировать числа, которые функция принуждает к строкам. Если вы указываете только одну строку, функция возвращает эту строку. При указании нескольких строк функция игнорирует нулевые значения и пустые строки. Нельзя указать нулевое значение или пустую строку в качестве единственного значения ввода.

Параметр

Тип данных

Необходимость

Описание

string...

Строка

Обязательное

Разделенный запятыми список одной или нескольких строк для конкатенации в одну строку. Чтобы разделить строки ввода в результате, добавьте строку разделителя (например, " ") между каждой парой строк. Можно конкатенировать числа, которые функция принуждает к строкам.

Если вы указываете только одну строку, функция возвращает эту строку. При указании нескольких строк функция игнорирует нулевые значения и пустые строки. Нельзя указать нулевое значение или пустую строку в качестве единственного значения ввода.

Пример контаминации строк и чисел

Формула: CONCAT("AGE", ": ", 23)

Значение возврата: "AGE: 23"

Пример контаминации числа и строки

Формула: CONCAT(23, " years of age")

Значение возврата: "23 years of age"

Пример загрязнения объекта JSON

Примеры данных:

"stringField1": "abc",
"stringField2": "ABC"

Формула: CONCAT(%stringField1%, " ", %stringField2%)

Значение возврата: "abc ABC"

Пример загрязнения объекта JSON

Примеры данных:

"Contact": {
  "FirstName": "Mike",
  "LastName": "Smith"
}

Формула: CONCAT(Contact:FirstName, " ", Contact:LastName)

Значение возврата: "Mike Smith"

Функция JOIN Omnistudio

Соединяет две или более строки в одну строку, разделяя каждую строку указанным маркером.

Подпись

JOIN(string..., token)

Значение возврата

Строка

Параметры

Параметр	Тип данных	Необходимость	Описание
`string...`	Строка	Обязательное	Разделенный запятыми список одной или нескольких строк для объединения в одну строку. В составном строке каждая указанная строка разделяется `маркером`. Вы можете объединять числа, которые функция принуждает к строкам. Если вы указываете только одну строку и маркер, функция возвращает только строку. Если вы укажете несколько значений, а любые будут нулевыми, функция пропустит нулевые значения в составную строку. Если вы укажете несколько значений и любые из них будут пустыми строками, функция присоединится только к значениям, предшествующим пустой строке. Нельзя указать нулевое значение или пустую строку в качестве единственного значения ввода.
`token`	Строка	Обязательное	Значение, размещаемое между каждой строкой ввода в положении, в котором строки соединяются. Если вы укажете число, функция принудительно превратит его в строку. Если вы укажете пустую строку, функция пропустит пустую строку в составную строку. Если вы укажете несколько строк ввода без маркера, функция использует последнее значение ввода в качестве маркера.

Параметр

Тип данных

Необходимость

Описание

string...

Строка

Обязательное

Разделенный запятыми список одной или нескольких строк для объединения в одну строку. В составном строке каждая указанная строка разделяется маркером. Вы можете объединять числа, которые функция принуждает к строкам. Если вы указываете только одну строку и маркер, функция возвращает только строку.

Если вы укажете несколько значений, а любые будут нулевыми, функция пропустит нулевые значения в составную строку. Если вы укажете несколько значений и любые из них будут пустыми строками, функция присоединится только к значениям, предшествующим пустой строке. Нельзя указать нулевое значение или пустую строку в качестве единственного значения ввода.

token

Строка

Обязательное

Значение, размещаемое между каждой строкой ввода в положении, в котором строки соединяются. Если вы укажете число, функция принудительно превратит его в строку. Если вы укажете пустую строку, функция пропустит пустую строку в составную строку. Если вы укажете несколько строк ввода без маркера, функция использует последнее значение ввода в качестве маркера.

Пример алфавитного массива

Примеры данных: "AlphabeticArray": [ "a", "A", "b", "B", "c", "C" ]

Формула: JOIN(AlphabeticArray, ", ")

Значение возврата: "a, A, b, B, c, C"

Пример числового массива

Примеры данных: "NumericArray": [ 1, 2, 3, 4 ]

Формула: JOIN(NumericArray, " / ")

Значение возврата: "1 / 2 / 3 / 4"

Пример объекта JSON

Примеры данных:

"Contact": {
  "FirstName": "Thomas",
  "MiddleName": "Alva",
  "LastName": "Edison"
}

Формула: JOIN(Contact:FirstName, Contact:MiddleName, Contact:LastName, " ")

Значение возврата: "Thomas Alva Edison"

Пример массива JSON

Примеры данных:

"Contacts": [
  {
    "id": "0036ab",
    "lastName": "Jones",
    "firstName": "Cathy"
  },
  {
    "id": "2787kq",
    "lastName": "Smith",
    "firstName": "Albert"
  },
  {
    "id": "3610xr",
    "lastName": "Smith",
    "firstName": "Ben"
  }
]

Формула: JOIN(Contacts:id, ', ')

Значение возврата: "0036ab, 2787kq, 3610xr"

Алфавитный список и пример отсутствия маркера

Формула: JOIN("a", "b", "c")

Формула: JOIN(("a", "b", "c"))

Значение возврата: "acb"

Функция Omnistudio MAXSTRING

Данная функция возвращает строку, расположенную последней лексикографически в списке двух или более строк.

Функция выполняет чувствительные к регистру сравнения строк ввода.

Подпись

MAXSTRING(string...)

Значение возврата

Строка

Параметры

Параметр	Тип данных	Необходимость	Описание
`string...`	Строка	Обязательное	Две или более строк, из которых должна быть возвращена последняя лексикографически строка. Если вы укажете числа, функция принудительно соединит их в строки. Если вы указываете только одну строку, функция возвращает эту строку. При указании нескольких строк функция игнорирует нулевые значения и пустые строки. Нельзя указать нулевое значение или пустую строку в качестве единственного значения ввода.

Параметр

Тип данных

Необходимость

Описание

string...

Строка

Обязательное

Две или более строк, из которых должна быть возвращена последняя лексикографически строка. Если вы укажете числа, функция принудительно соединит их в строки.

Пример максимальной строки

Формула: MAXSTRING("Amy", "Ziggy", "Michael")

Значение возврата: "Ziggy"

Пример максимального числа

Формула: MAXSTRING(1, 2, 3)

Значение возврата: "3"

Пример прописных символов

Формула: MAXSTRING("A", "B", "C")

Значение возврата: "C"

Пример символов верхнего и нижнего регистров

Формула: MAXSTRING("A", "b", "C")

Значение возврата: "b"

Функция Omnistudio SPLIT

Разделяет строку на подстроки в каждой позиции указанного маркера.

Функция выполняет чувствительный к регистру поиск маркера. Если функция разделяет строку ввода на две или более подстрок, она возвращает массив строк. В противном случае возвращается строка ввода.

Подпись

SPLIT(string, token)

Значение возврата

String[]

Параметры

Параметр	Тип данных	Необходимость	Описание
`string`	Строка	Обязательное	Строка для разделения на подстроки. Если вы укажете число, функция принудительно превратит его в строку. Строка не может быть нулевой или пустой.
`token`	Строка	Обязательное	Строка, определяющая расположение строки ввода для разделения на подстроки. Функция разделяет строку при каждом экземпляре маркера. Маркер не добавляется в возвращаемые подстроки. Если вы укажете число, функция принудительно превратит его в строку. Функция возвращает строку ввода, если маркер отсутствует в строке. При указании нулевого маркера функция возвращает строку ввода. Если вы укажете пустую строку в качестве маркера, функция вернет массив, содержащий каждый символ значения ввода.

Параметр

Тип данных

Необходимость

Описание

string

Строка

Обязательное

Строка для разделения на подстроки. Если вы укажете число, функция принудительно превратит его в строку. Строка не может быть нулевой или пустой.

token

Строка

Обязательное

Строка, определяющая расположение строки ввода для разделения на подстроки. Функция разделяет строку при каждом экземпляре маркера. Маркер не добавляется в возвращаемые подстроки. Если вы укажете число, функция принудительно превратит его в строку. Функция возвращает строку ввода, если маркер отсутствует в строке.

При указании нулевого маркера функция возвращает строку ввода. Если вы укажете пустую строку в качестве маркера, функция вернет массив, содержащий каждый символ значения ввода.

Пример строки доли

Примеры данных: %Name% == "Anne Marie Gupta"

Формула: SPLIT(%Name%, " ")

Значение возврата: [ "Anne", "Marie", "Gupta" ]

Пример доли числа

Формула: SPLIT(12345, 3)

Значение возврата: [ "12", "45" ]

Пример маркера не найден

Формула: SPLIT("abcde", "C")

Значение возврата: "abcde"

Функция Omnistudio STRINGINDEXOF

Возвращает начальный индекс подстроки в строке.

Функция выполняет чувствительный к регистру поиск подстроки. Расположение первого символа строки: 0. Если подстрока повторяется несколько раз в строке, функция возвращает индекс первого экземпляра. Если функция не находит подстроку в строке, она возвращает -1.

Подпись

STRINGINDEXOF(string, substring)

Значение возврата

Целое число

Параметры

Параметр	Тип данных	Необходимость	Описание
`string`	Строка	Обязательное	Строка для поиска `substring`. Если вы укажете число, функция принудительно превратит его в строку. Строка не может быть нулевой или пустой.
`substring`	Строка	Обязательное	Подстрока для поиска в `string`. Если вы укажете число, функция принудительно превратит его в строку. Подстрока не может быть нулевой или пустой.

Пример найденной подстроки

Формула: STRINGINDEXOF("This is the test string.", "test")

Значение возврата: 12

Пример подстроки не найден

Формула: STRINGINDEXOF("This is the test string.", "testy")

Значение возврата: -1

Пример нескольких экземпляров подстроки

Формула: STRINGINDEXOF("The string of strings.", "string")

Значение возврата: 4

Пример числовых значений

Формула: STRINGINDEXOF(1234, 34)

Значение возврата: 2

Функция ПОДСТРОКИ Omnistudio

Возвращает подстроку строки на основе указанных начальных и конечных индексов.

Расположение первого символа в string: 0. Расположение последнего символа в string - длина строки. Функция выполняет чувствительный к регистру поиск символов или строк, используемых в качестве начального или конечного индекса.

Подпись

SUBSTRING(string, startIndex, endIndex)

Значение возврата

Строка

Параметры

Параметр	Тип данных	Необходимость	Описание
`string`	Строка	Обязательное	Строка, из которой должна быть возвращена подстрока. Строка не может быть нулевой или пустой.
`startIndex`	Целое число или строка	Дополнительно	Положение первого символа в подстроке. Начальный индекс является включающим, поэтому расположение символа кулака будет `0`. При указании отрицательного целого числа или целого числа, превышающего длину строки, функция использует `0`. Если вы указываете один символ, функция использует положение первого экземпляра этого символа. При указании строки функция использует положение первого символа первого экземпляра строки. При указании нулевой или пустой строки функция использует `0`. Если вы пропускаете начальный индекс, функция использует `0` по умолчанию. В этом случае нужно также пропустить конечный индекс.
`endIndex`	Целое число или строка	Дополнительно	Положение последнего символа в подстроке. Конечный индекс является эксклюзивным, поэтому позиция последнего символа является длиной строки. При указании отрицательного целого числа или целого числа, превышающего длину строки, функция использует длину строки. При указании одного символа функция использует положение первого экземпляра этого символа минус один. При указании строки функция использует положение первого символа первого экземпляра строки минус один. При указании нулевой или пустой строки функция использует длину строки. Если вы пропускаете конечный индекс, функция использует длину строки по умолчанию. Если вы указываете конечный индекс, необходимо также указать начальный индекс.

Параметр

Тип данных

Необходимость

Описание

string

Строка

Обязательное

Строка, из которой должна быть возвращена подстрока. Строка не может быть нулевой или пустой.

startIndex

Целое число или строка

Дополнительно

Положение первого символа в подстроке. Начальный индекс является включающим, поэтому расположение символа кулака будет 0.

При указании отрицательного целого числа или целого числа, превышающего длину строки, функция использует 0.
Если вы указываете один символ, функция использует положение первого экземпляра этого символа.
При указании строки функция использует положение первого символа первого экземпляра строки.
При указании нулевой или пустой строки функция использует 0.

Если вы пропускаете начальный индекс, функция использует 0 по умолчанию. В этом случае нужно также пропустить конечный индекс.

endIndex

Целое число или строка

Дополнительно

Положение последнего символа в подстроке. Конечный индекс является эксклюзивным, поэтому позиция последнего символа является длиной строки.

При указании отрицательного целого числа или целого числа, превышающего длину строки, функция использует длину строки.
При указании одного символа функция использует положение первого экземпляра этого символа минус один.
При указании строки функция использует положение первого символа первого экземпляра строки минус один.
При указании нулевой или пустой строки функция использует длину строки.

Если вы пропускаете конечный индекс, функция использует длину строки по умолчанию. Если вы указываете конечный индекс, необходимо также указать начальный индекс.

Пример индекса отсутствия начала или окончания