Модуль:String2/документація

Модуль String2 містить кілька функцій для роботи з рядками, які є менш поширеними ніж ті, що в contains Модуль:String.

Функції

as

Функція as повертає частину рядка після вказаного символу (after symbol).

Використання

{{#invoke:String2|as|рядок|символ}}

Параметри
  • рядок: Рядок, з якого потрібно виключити вказаний символ (в його першому входженні зліва) і усі символи перед ним.
  • символ: Межовий символ.
Розмітка Рендериться як
{{#invoke:string2|as|search|a}}

rch

bs

Функція bs повертає частину рядка перед вказаного символу (before symbol).

Використання

{{#invoke:String2|bs|рядок|символ}}

Параметри
  • рядок: Рядок, з якого потрібно виключити вказаний символ (в його першому входженні зліва) і усі символи після нього.
  • символ: Межовий символ.
Розмітка Рендериться як
{{#invoke:string2|as|search|a}}

se

formatRound

Функція formatRound округлює десяткове число до вказаної кількості цифр після коми.

Використання

{{#invoke:String2|formatRound|число|кількість_цифр}}

Параметри
  • число: Десяткове число, яке потрібно округлити. Наприклад, 3.14159265.
  • кількість_цифр: Задає кількість цифр, які мають бути після коми. Наприклад, 3.
Розмітка Рендериться як
{{#invoke:string2|formatRound|3.14159265|3}}

3.142

join

Функція join повертає рядок з об'єднаними аргументами вихідного шаблону.

Використання

{{#invoke:String2|join|роздільник|сполучник|параметр|from=початковий_елемент|to=кінецевий_елемент}}

Параметри
  • роздільник: Роздільник, що розділяє список елементів. Наприклад, кома (,).
  • сполучник: Сполучник, що сполучає два останніх елементи. Наприклад, та.
  • параметр: Задає роботу об'єднання при пустих рядків чи рядків, що складаються з пробілів. Доступні параметри: _ — пусті рядки ігноруються; s — прядки з пробілами ігноруються.
  • |from=: Задає номер початкового елементу списку, з якого потрібно починати об'єднання. Наприклад, 2.
  • |to=: Задає номер кінцевого елементу списку, з яким потрібно закінчити об'єднання. Наприклад, 5.

Примітка: Прямий виклик функції через модуль не працюватиме, потрібно, щоб використовувався як виклик через шаблон. Наприклад, якщо шаблон міститиме код вище, то тоді використання шаблону виглядатиме так: {{str2join|елемент1|елемент2|елемент3}}, де елемент1, елемент2 ... елементn — є елементами списку, наприклад, яблуко.

Якщо припустимо, що є шаблон str2join, що містить код {{#invoke:String2|join|,|та|s}}, то код {{str2join|яблуко|груша|слива}} дає результат: яблуко, груша та слива.

split

Функція split розділяє текст за межами вказаними роздільником та повертає частину для індексу idx (починається з 1). Вона може використовувати позиційні або іменовані параметри (але вони не повинні змішуватися):

Використання
{{#invoke:String2 |split |текст |роздільник |індекс |true/false}}
{{#invoke:String2 |split |txt=текст |sep=роздільник |idx=індекс |plain=true/false}}

Будь-які подвійні лапки (") у параметрі роздільника видаляються, що дозволяє передавати пробіли й вікітекст ось так ["[. Використайте {{!}} для символу вертикальної риски |.

Якщо вказано значення false / no / 0 необов'язковому параметру plain, то тоді роздільник оброблюється як шаблон/патерн Lua. Стандартним значенням є plain=true, тобто зіставлення з нормальним текстом.

Параметр індексу є необов'язковим; стандартним значенням є перша частина тексту.

{{string split}} є зручною обгорткою для функції split.

startswith

Функція startswith подібна до {{#invoke:string|endswith}}. Обидва параметри є обов'язковими, хоча вони можуть бути пустими. Пробіл на початку і в кінці враховується, використовауйте іменовані параметри, щоб цього уникнути, якщо це необхідно. Виводить «yes» для true та пусте значення для false, то може напряму передаватися до #if.

Розмітка Рендериться як
{{#invoke:string2|startswith|search|se}}

yes

{{#invoke:string2|startswith|search|ch}}

Tr

Trg

trg

ucfirst

Функція ucfirst перетворює перший абетковий символ на велику літеру, але не чіпає капіталізацію всього іншого тексту. Це корисно, якщо текст містить власні назви, але вона не упорядковує речення, які, наприклад, містять весь текст великими літерами. Також працює з текстом, що містить вікіпосилання з вертикальними рисками та з html списками.


Prefix: a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9

Portal di Ensiklopedia Dunia

Kembali kehalaman sebelumnya