string

string.contains

Описание: Проверяет вхождение строк разными способами.

Параметры:

• text - исходная строка (обязательный)
• search - искомое значение (обязательный)
• type - тип поиска (опциональный):
  • substring - поиск подстроки (значение по умолчанию)
  • chars - поиск отдельных символов
  • prefix - проверка начинается ли строка с указанного значения
  • suffix - проверка заканчивается ли строка указанным значением

Возвращает: true если найдено совпадение, false если нет.

Пример

Поиск подстроки

!{string.contains|
  text: "Hello world"; 
  search: "world";}

Результат:

true

Поиск символов

!{string.contains|
  text: "Hello"; 
  type: chars; 
  search: "abc";}  

Результат:

false

Проверка префикса

!{string.contains|
  text: "prefix-test"; 
  type: prefix; 
  search: "prefix";}

Результат:

true

Проверка суффикса

!{string.contains|
  text: "test-suffix"; 
  type: suffix; 
  search: "suffix";}

Результат:

true

string.index

Описание: Находит позицию вхождения подстроки.

Параметры:

• text - исходная строка (обязательный)
• search - искомая подстрока (обязательный)
• type - тип поиска (опциональный):
  • first - поиск первого вхождения (значение по умолчанию)
  • last - поиск последнего вхождения
• mode - режим индексации (опциональный):Макросы.md
  • utf8 - по символам UTF-8 (значение по умолчанию)
  • byte - по байтам

Возвращает: Индекс вхождения или -1 если подстрока не найдена.

Пример

Поиск с UTF-8 индексацией (по умолчанию)

!{string.index|text: Привет мир; search: мир;}

Результат:

7

Поиск с байтовой индексацией

!{string.index|text: Привет мир; mode: byte; search: мир;} 

Результат: 13 (т.к. "Привет " занимает 13 байт в UTF-8)

string.cut

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

Параметры:

• text - исходная строка (обязательный)
• start - начальный индекс, включительно (опциональный)
• end - конечный индекс, не включительно (опциональный)
• index - индекс конкретного символа (опциональный)
• mode - режим индексации (опциональный):
  • utf8 - по символам UTF-8 (значение по умолчанию)
  • byte - по байтам

Возвращает: Вырезанную часть строки или символ.

Пример

Получение символа по индексу

!{string.cut|text: Привет мир; index: 2; mode: utf8;}

Результат:

"и"

Вырезание с начального индекса до конца

!{string.cut|text: Привет мир; start: 7; mode: utf8;}

Результат:

"мир"

Вырезание с начала до указанного индекса

!{string.cut|
  text: Привет мир; 
  end: 6; 
  mode: utf8;}

Результат:

"Привет"

Вырезание части между индексами

!{string.cut|
  text: Привет мир; 
  start: 0; 
  end: 6; 
  mode: utf8;}

Результат:

"Привет"

string.reverse

Описание: Разворачивает строку в обратном порядке.

Параметры:

• text - исходная строка (обязательный или через all)

Возвращает: Развернутую строку.

Пример

!{string.reverse|text: Привет;}

Результат:

"тевирП"

string.truncate

Описание: Обрезает строку до указанной длины с добавлением окончания.

Параметры:

• text - исходная строка (обязательный)
• length - максимальная длина (обязательный)
• suffix - окончание обрезанной строки (опциональный, по умолчанию "...")
• type - тип обрезки (опциональный):
  • word - обрезать по последнему полному слову (значение по умолчанию)
  • symbol - обрезать строго по символам
• mode - режим индексации (опциональный):
  • utf8 - по символам UTF-8 (значение по умолчанию)
  • byte - по байтам

Возвращает: Обрезанную строку с добавленным суффиксом.

Пример

Обрезка по словам с UTF-8 индексацией (по умолчанию)

!{string.truncate|
 text: Очень длинная строка текста; 
 length: 12;}

Результат:

"Очень длинная..."

Обрезка по символам с UTF-8 индексацией

!{string.truncate|
  text: Очень длинная строка текста; 
  length: 12; type: 
  symbol;}

Результат:

"Очень длинна..."

Обрезка по байтам

!{string.truncate|
  text: Очень длинная строка текста; 
  length: 12; 
  type: symbol; 
  mode: byte;}

Результат:

"Оче..." (т.к. кириллические символы занимают по 2 байта в UTF-8)

С изменённым окончанием

!{string.truncate|
  text: Очень длинная строка текста; 
    length: 12; 
    suffix: …;}

Результат:

"Очень длинная…"

string.case

Описание: Изменяет регистр строки.

Параметры:

• text - исходная строка (обязательный)
• type - тип преобразования (опциональный):
  • lower - перевод в нижний регистр (значение по умолчанию)
  • upper - перевод в верхний регистр

Возвращает: Строку с измененным регистром.

Пример:

!{string.case|
  text: Строка для преобразования; 
  type: upper;}

Результат:

"СТРОКА ДЛЯ ПРЕОБРАЗОВАНИЯ"

string.split

Описание: Разделяет строку на массив подстрок.

Параметры:

• text - исходная строка (обязательный)
• separator - разделитель (опциональный, если не указан или пустой, строка разделяется по пробельным символам)

Возвращает: Массив подстрок в формате JSON.

Примеры:

Разделение по запятой

!{string.split|
  text: red,green,blue; 
  separator: ,;}

Результат:

["red", "green", "blue"]

Разделение по пробелам (separator не указан)

!{string.split|
  text: The quick brown fox;}

Результат:

["The", "quick", "brown", "fox"]

Разделение по нескольким символам

!{string.split|
  text: 1->2->3; 
  separator: ->;}

Результат:

["1", "2", "3"]

string.join

Описание: Объединяет массив строк через указанный разделитель.

Параметры:

• list - массив строк в JSON формате (обязательный)
• separator - разделитель для объединения (опциональный, по умолчанию пустая строка)

Возвращает: Объединенную строку.

Пример

!{string.join|
  list: ["строка1", "строка2", "строка3"]; 
  separator: ", ";}

Результат:

"строка1, строка2, строка3"

string.trim

Описание: Удаляет указанные символы с начала и/или конца строки.

Параметры:

• text - исходная строка (обязательный)
• type - тип удаления (опциональный):
  • both - удаление с обоих концов (значение по умолчанию)
  • left - удаление только слева
  • right - удаление только справа
  • space - удаление пробельных символов с обоих концов
• search - символы для удаления (обязательный для всех типов кроме space)

Возвращает: Строку с удаленными символами.

Пример

Удаление пробелов

!{string.trim|text: "   Строка с пробелами   "; type: space;}

Результат:

"Строка с пробелами"

Удаление конкретных символов слева

!{string.trim|
  text: "***Текст***"; 
  type: left; 
  search: *;}

Результат:

"Текст***"

string.replace

Описание: Заменяет подстроки в тексте.

Параметры:

• text - исходная строка (обязательный)
• old - подстрока для замены (обязательный)
• new - строка замены (обязательный, может быть пустой)
• type - тип замены (опциональный):
  • first - замена только первого вхождения (значение по умолчанию)
  • all - замена всех вхождений
  • count - замена указанного количества вхождений
• count - количество замен для type: count (обязательный при type: count)

Возвращает: Строку с выполненными заменами.

Пример

Замена первого вхождения

!{string.replace|
  text: Привет, мир! Привет!; 
  old: Привет; 
  new: Здравствуй;}

Результат:

"Здравствуй, мир! Привет!"

Замена всех вхождений

!{string.replace|
  text: Привет, мир! Привет!; 
  old: Привет; 
  new: Здравствуй; 
  type: all;}

Результат:

"Здравствуй, мир! Здравствуй!"

Замена указанного количества вхождений

!{string.replace|
  text: Привет, Привет, Привет!; 
  old: Привет; new: Здравствуй; 
  type: count; 
  count: 2;}

Результат:

"Здравствуй, Здравствуй, Привет!"

string.count

Описание: Подсчитывает количество непересекающихся вхождений подстроки.

Параметры:

• text - исходная строка (обязательный)
• search - искомая подстрока (обязательный)

Возвращает: Число вхождений в виде строки.

Пример:

!{string.count|
  text: Привет, мир! Привет!; 
  search: Привет;}

Результат:

"2"

string.repeat

Описание: Повторяет строку указанное количество раз.

Параметры:

• text - исходная строка (обязательный)
• count - количество повторов (обязательный)

Возвращает: Повторенную строку.

Пример:

!{string.repeat|
  text: Привет!; 
  count: 3;}

Результат:

"Привет!Привет!Привет!"