#Форматирование текста

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

#1. :lowerCase

#Описание синтаксиса

Преобразует все буквы в нижний регистр.

#Пример

'My Car':lowerCase()   // Выводит "my car"
'my car':lowerCase()   // Выводит "my car"
null:lowerCase()       // Выводит null
1203:lowerCase()       // Выводит 1203

#Результат

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

#2. :upperCase

#Описание синтаксиса

Преобразует все буквы в верхний регистр.

#Пример

'My Car':upperCase()   // Выводит "MY CAR"
'my car':upperCase()   // Выводит "MY CAR"
null:upperCase()       // Выводит null
1203:upperCase()       // Выводит 1203

#Результат

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

#3. :ucFirst

#Описание синтаксиса

Преобразует только первую букву строки в верхний регистр, оставляя остальные без изменений.

#Пример

'My Car':ucFirst()     // Выводит "My Car"
'my car':ucFirst()     // Выводит "My car"
null:ucFirst()         // Выводит null
undefined:ucFirst()    // Выводит undefined
1203:ucFirst()         // Выводит 1203

#Результат

Результат вывода указан в комментариях.

#4. :ucWords

#Описание синтаксиса

Преобразует первую букву каждого слова в строке в верхний регистр.

#Пример

'my car':ucWords()     // Выводит "My Car"
'My cAR':ucWords()     // Выводит "My CAR"
null:ucWords()         // Выводит null
undefined:ucWords()    // Выводит undefined
1203:ucWords()         // Выводит 1203

#Результат

Результат вывода показан в примерах.

#5. :print(message)

#Описание синтаксиса

Всегда возвращает указанное сообщение, независимо от исходных данных. Это полезно, когда форматировщик используется в качестве запасного варианта. Параметр:

• message: Текст для вывода.

#Пример

'My Car':print('hello!')   // Выводит "hello!"
'my car':print('hello!')   // Выводит "hello!"
null:print('hello!')       // Выводит "hello!"
1203:print('hello!')       // Выводит "hello!"

#Результат

Во всех случаях возвращается указанная строка "hello!".

#6. :printJSON

#Описание синтаксиса

Преобразует объект или массив в строку в формате JSON.

#Пример

[{'id':2,'name':'homer'},{'id':3,'name':'bart'}]:printJSON()
// Выводит "[
  {"id": 2, "name": "homer"},
  {"id": 3, "name": "bart"}
]"
'my car':printJSON()   // Выводит ""my car""

#Результат

Результатом является строка в формате JSON, полученная из исходных данных.

#7. :unaccent

#Описание синтаксиса

Удаляет диакритические знаки (знаки ударения) из текста, преобразуя его в формат без ударений.

#Пример

'crème brulée':unaccent()   // Выводит "creme brulee"
'CRÈME BRULÉE':unaccent()   // Выводит "CREME BRULEE"
'être':unaccent()           // Выводит "etre"
'éùïêèà':unaccent()       // Выводит "euieea"

#Результат

Во всех примерах выводятся тексты без диакритических знаков.

#8. :convCRLF

#Описание синтаксиса

Преобразует символы возврата каретки и новой строки (\r\n или \n) в теги разрыва строки, специфичные для документа. Это полезно для таких форматов, как DOCX, PPTX, ODT, ODP и ODS. Обратите внимание: При использовании :html перед :convCRLF символы \r\n преобразуются в тег <br>.

#Пример

// Для формата ODT:
'my blue 
 car':convCRLF()    // Выводит "my blue <text:line-break/> car"
'my blue 
 car':convCRLF()    // Выводит "my blue <text:line-break/> car"

// Для формата DOCX:
'my blue 
 car':convCRLF()    // Выводит "my blue </w:t><w:br/><w:t> car"
'my blue 
 car':convCRLF()    // Выводит "my blue </w:t><w:br/><w:t> car"

#Результат

Результат вывода показывает маркеры разрыва строки, соответствующие целевому формату документа.

#9. :substr(begin, end, wordMode)

#Описание синтаксиса

Выполняет операцию извлечения подстроки, начиная с индекса begin (отсчет с 0) и заканчивая непосредственно перед индексом end. Необязательный параметр wordMode (булево значение или last) определяет, следует ли избегать разрыва слова посередине, сохраняя его целостность.

#Пример

'foobar':substr(0, 3)            // Выводит "foo"
'foobar':substr(1)               // Выводит "oobar"
'foobar':substr(-2)              // Выводит "ar"
'foobar':substr(2, -1)           // Выводит "oba"
'abcd efg hijklm':substr(0, 11, true)  // Выводит "abcd efg "
'abcd efg hijklm':substr(1, 11, true)  // Выводит "abcd efg "

#Результат

Результатом является подстрока, извлеченная в соответствии с заданными параметрами.

#10. :split(delimiter)

#Описание синтаксиса

Разделяет строку на массив, используя указанный разделитель. Параметр:

• delimiter: Строка-разделитель.

#Пример

'abcdefc12':split('c')    // Выводит ["ab", "def", "12"]
1222.1:split('.')         // Выводит ["1222", "1"]
'ab/cd/ef':split('/')      // Выводит ["ab", "cd", "ef"]

#Результат

В результате примера получается массив, разделенный заданным разделителем.

#11. :padl(targetLength, padString)

#Описание синтаксиса

Дополняет строку слева указанным символом до тех пор, пока ее итоговая длина не достигнет targetLength. Если целевая длина меньше длины исходной строки, возвращается исходная строка. Параметры:

• targetLength: Желаемая общая длина.
• padString: Строка, используемая для заполнения (по умолчанию — пробел).

#Пример

'abc':padl(10)              // Выводит "       abc"
'abc':padl(10, 'foo')       // Выводит "foofoofabc"
'abc':padl(6, '123465')     // Выводит "123abc"
'abc':padl(8, '0')          // Выводит "00000abc"
'abc':padl(1)               // Выводит "abc"

#Результат

Каждый пример выводит строку, дополненную слева.

#12. :padr(targetLength, padString)

#Описание синтаксиса

Дополняет строку справа указанным символом до тех пор, пока ее итоговая длина не достигнет targetLength. Параметры такие же, как и для :padl.

#Пример

'abc':padr(10)              // Выводит "abc       "
'abc':padr(10, 'foo')       // Выводит "abcfoofoof"
'abc':padr(6, '123465')     // Выводит "abc123"
'abc':padr(8, '0')          // Выводит "abc00000"
'abc':padr(1)               // Выводит "abc"

#Результат

Результат вывода — строка, дополненная справа.

#13. :ellipsis(maximum)

#Описание синтаксиса

Если текст превышает указанное количество символов, в конце добавляется многоточие ("..."). Параметр:

• maximum: Максимально допустимое количество символов.

#Пример

'abcdef':ellipsis(3)      // Выводит "abc..."
'abcdef':ellipsis(6)      // Выводит "abcdef"
'abcdef':ellipsis(10)     // Выводит "abcdef"

#Результат

В примерах показан текст, усеченный и дополненный многоточием, если это необходимо.

#14. :prepend(textToPrepend)

#Описание синтаксиса

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

• textToPrepend: Текст префикса.

#Пример

'abcdef':prepend('123')     // Выводит "123abcdef"

#Результат

Результат вывода — текст с добавленным префиксом.

#15. :append(textToAppend)

#Описание синтаксиса

Добавляет указанный текст в конец строки. Параметр:

• textToAppend: Текст суффикса.

#Пример

'abcdef':append('123')      // Выводит "abcdef123"

#Результат

Результат вывода — текст с добавленным суффиксом.

#16. :replace(oldText, newText)

#Описание синтаксиса

Заменяет все вхождения oldText в тексте на newText. Параметры:

• oldText: Текст, который нужно заменить.
• newText: Новый текст для замены. Обратите внимание: Если newText имеет значение null, это означает, что соответствующий текст должен быть удален.

#Пример

'abcdef abcde':replace('cd', 'OK')    // Выводит "abOKef abOKe"
'abcdef abcde':replace('cd')          // Выводит "abef abe"
'abcdef abcde':replace('cd', null)      // Выводит "abef abe"
'abcdef abcde':replace('cd', 1000)      // Выводит "ab1000ef ab1000e"

#Результат

Результатом является текст после замены указанных фрагментов.

#17. :len

#Описание синтаксиса

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

#Пример

'Hello World':len()     // Выводит 11
'':len()                // Выводит 0
[1,2,3,4,5]:len()       // Выводит 5
[1,'Hello']:len()       // Выводит 2

#Результат

Выводит соответствующую длину в виде числа.

#18. :t

#Описание синтаксиса

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

#19. :preserveCharRef

#Описание синтаксиса

По умолчанию некоторые недопустимые символы XML (такие как &, >, <, и т.д.) удаляются. Этот форматировщик сохраняет ссылки на символы (например, § остается без изменений) и подходит для сценариев генерации XML, где это необходимо. Примеры и результаты зависят от конкретного сценария использования.