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

Цей розділ пропонує різні форматувальники для текстових даних. Нижче ми послідовно розглянемо синтаксис, приклади та результати роботи кожного форматувальника.

#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 (з нуля) і закінчуючи безпосередньо перед індексом 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.
Приклади та результати залежать від конкретного випадку використання.