Modulis:String/doc

len

Tiek atgriezts simbolu virknes garums

Lietojums:

{{#invoke:String|len|target_string}}

vai

{{#invoke:String|len|s= target_string }}

Parametri:

s: Simbolu virkne, kuras garums ir jānoskaidro

Kods	Rezultāts
{{#invoke:String\|len}}	0
{{#invoke:String\|len\|}}	0
{{#invoke:String\|len\| }}	1
{{#invoke:String\|len\|ab cde}}	6
{{#invoke:String\|len\| ab cde }}	8
{{#invoke:String\|len\|s= ab cde }}	6
{{#invoke:String\|len\| 1234567 }}	9
{{#invoke:String\|len\| café åäö }}	10
{{#invoke:String\|len\| Man garšo persiki! }}	20
{{#invoke:String\|len\| 499 simboli... }}	499
{{#invoke:String\|len\| 1000 simboli... }}	1000

sub

Funkcija atgriež simbolu virknes apakšvirkni, kas sākas noteiktā pozīcijā

Lietojums:

{{#invoke:String|sub|target_string|start_index|end_index}}

vai

{{#invoke:String|sub|s= target_string |i= start_index |j= end_index }}

Parameters:

s: Apstrādājamā virkne
i: Atgriežamās apakšvirknes pirmā pozīcija, pēc noklusējuma — 1. simbols
j: Atgriežamās apakšvirknes pēdējā pozīcija, pēc noklusējuma — virknes pēdējais simbols

Ja i vai j ir negatīva vērtība, tad skaitīšana tiek sākta ar pēdējo pozīciju. Tātad vērtība -1 ir pēdējais simbolu virknes loceklis.

Ja norādītās vērtības ir ārpus simbolu virknes robežām, tiek izdots kļūdas paziņojums.

Kods	Rezultāts
{{#invoke:String\|sub\|ŠeitIrSimboluVirkne\|i=7\|j=13}}	Simbolu
{{#invoke:String\|sub\|ŠeitIrSimboluVirkne\|j=4}}	Šeit
{{#invoke:String\|sub\|ŠeitIrSimboluVirkne}}	ŠeitIrSimboluVirkne
{{#invoke:String\|sub\|ŠeitIrSimboluVirkne\|i=-6}}	Virkne
{{#invoke:String\|sub\|ŠeitIrSimboluVirkne\|i=20}}	Kļūda: apakšvirknes pirmā pozīcija ārpus robežām

Kods	Rezultāts
{{#invoke:String\|sub\|s= ŠeitIrSimboluVirkne \|i=7\|j=13}}	Simbolu
{{#invoke:String\|sub\|s= ŠeitIrSimboluVirkne \|j=4}}	Šeit
{{#invoke:String\|sub\|s= ŠeitIrSimboluVirkne }}	ŠeitIrSimboluVirkne
{{#invoke:String\|sub\|s= ŠeitIrSimboluVirkne \|i=-6}}	Virkne
{{#invoke:String\|sub\|s= ŠeitIrSimboluVirkne \|i=20}}	Kļūda: apakšvirknes pirmā pozīcija ārpus robežām

sublength

Piezīme: neizmantot!

Tiek implementēta veidne {{str sub}}.

match

Tiek atgriezta apakšvirkne no sākotnējās simbolu virknes, kas atbilst noteiktām prasībām.

Lietojums:

{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}

vai

{{#invoke:String|match|s= source_string |pattern= pattern_string |start= start_index|match= match_number|plain= plain_flag |nomatch= nomatch_output }}

Parametri:

s: Apstrādājamā virkne
pattern: izteiksme vai simbolu virkne, kas jāmeklē
start: Apstrādājamās virknes simbola pozīcija, ar kuru jāsāk meklēšana. Pēc noklusējuma — pirmais simbols
match: Dažkārt ir iespējams, ka simbolu virknē atrastas vairākas atbilstības. Šajā parametrā var norādīt nepieciešamās simbolu virknes sakrišanas reizi, piemēram, |match=1. Ja tiek norādīta negatīva vērtība, tad meklēšana tiek sākta ar simbolu virknes beigām (t.i., |match=-1 atgriež pēdējo sakritību). Pēc noklusējuma — 1. sakrišana
plain: Karogs, kas norāda, ka izteiksme jāuztver kā parasts teksts, nevis regulārā izteiksme. Pēc noklusējuma nepatiess (false)
nomatch: Ja netika atrasta sakritība, tad tiek parādīta "nomatch" vērtība, nevis kļūdas paziņojums

Ja norādītās vērtības ir ārpus simbolu virknes robežām, tiek izdots kļūdas paziņojums. Kļūdas paziņojums tiek izdots arī, ja netiek atrasta sakritība.

Ja |ignore_errors=true, tad tiek atgriezta tukša simbolu virkne.

Lua regulārās izteiksmes:

pos

Tiek atgriezta simbolu virknes vērtība, kas atrodas pos vietā.

Lietojums:

{{#invoke:String|pos|target_string|index_value}}

vai

{{#invoke:String|pos|target= target_string |pos= index_value }}

Parametri:

target: Apstrādājamā virkne
pos: Nepieciešamā simbola pozīcija

Ja tiek norādīta negatīva vērtība, tad meklēšana tiek sākta ar simbolu virknes beigām (|pos=-1 atgriež pēdējo simbolu).

Ja tiek ievadīts |pos=0 (vai skaitlis, kas lielāks par simbolu skaitu virknē), tiek izvadīts kļūdas paziņojums.

Kods	Rezultāts
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|1}}	Š
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|-1}}	e
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|6}}	r
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne}}	Kļūda: pozīcijas indekss ir ārpus robežām
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|0}}	Kļūda: pozīcijas indekss ir ārpus robežām
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|30}}	Kļūda: pozīcijas indekss ir ārpus robežām
{{#invoke:String\|pos\|ŠeitIrSimboluVirkne\|-30}}	Kļūda: pozīcijas indekss ir ārpus robežām

str_find

Piezīme: neizmantot! Šīs funkcijas vietā izmantojama find funkcija.

This function duplicates the behavior of {{str_find}}, including all of its quirks. This is provided in order to support existing templates, but is NOT RECOMMENDED for new code and templates. New code is recommended to use the "find" function instead.

Returns the first index in "source" that is a match to "target". Indexing is 1-based, and the function returns -1 if the "target" string is not present in "source".

Important Note: If the "target" string is empty / missing, this function returns a value of "1", which is generally unexpected behavior, and must be accounted for separatetly.

find

Tiek meklēta simbolu virkne vai izteiksme citā simbolu virknē

Lietojums:

{{#invoke:String|find|source_str|target_string|start_index|plain_flag}}

vai

{{#invoke:String|find|source= source_str |target= target_str |start= start_index|plain= plain_flag }}

Parametri:

source: Apstrādājamā virkne
target: izteiksme vai simbolu virkne, kas jāmeklē
start: Apstrādājamās virknes indekss, ar kuru jāsāk meklēšana. Pēc noklusējuma — pirmais simbols
plain: Karogs, kas norāda, ka izteiksme jāuztver kā parasts teksts, nevis regulārā izteiksme. Pēc noklusējuma patiess (true)

Atgriež pirmo simbola pozīciju, kas lielāks/vienāds ar "start", ja "target" tiek atrasts "source". Ja "target" nav atrasts, "source" vai "target" ir tukšs vai nav vispār, tiek atgriezta 0.

Kods	Rezultāts
{{#invoke:String\|find\|abcdef\|abc}}	1
{{#invoke:String\|find\|abcdef\|def}}	4
{{#invoke:String\|find\|abcdef\|efg}}	0
{{#invoke:String\|find\|abcdef\|ghi}}	0
{{#invoke:String\|find\|abcdef\|abcdefghi}}	0

replace

Tiek aizvietota simbolu virkne vai izteiksme citā simbolu virknē

Lietojums:

{{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}

vai

{{#invoke:String|replace|source= source_string |pattern= pattern_string|replace= replace_string |count= replacement_count |plain= plain_flag }}

Parametri:

source: Apstrādājamā virkne
pattern: izteiksme vai simbolu virkne, kas jāmeklē
replace: Teksts, ar ko aizvietot atrasto rezultātu
count: Aizvietošanas reižu skaits. Pēc noklusējuma aizvieto visu atrasto
plain: Karogs, kas norāda, ka izteiksme jāuztver kā parasts teksts, nevis regulārā izteiksme. Pēc noklusējuma patiess (true)

rep

Atkārto simbolu virkni n reizes

Lietojums:

{{#invoke:String|rep|source|count}}

Parametri:

source: Simbolu virkne, kas jāatkārto
count: Atkārtošanas reižu skaits

Kods	Rezultāts
{{#invoke:String\|len}}	0
{{#invoke:String\|len\|}}	0
{{#invoke:String\|len\| }}	1
{{#invoke:String\|len\|ab cde}}	6
{{#invoke:String\|len\| ab cde }}	8
{{#invoke:String\|len\|s= ab cde }}	6
{{#invoke:String\|len\| 1234567 }}	9
{{#invoke:String\|len\| café åäö }}	10
{{#invoke:String\|len\| Man garšo persiki! }}	20
{{#invoke:String\|len\| 499 simboli... }}	499
{{#invoke:String\|len\| 1000 simboli... }}	1000

Kods	Rezultāts
{{#invoke:String\|find\|abcdef\|abc}}	1
{{#invoke:String\|find\|abcdef\|def}}	4
{{#invoke:String\|find\|abcdef\|efg}}	0
{{#invoke:String\|find\|abcdef\|ghi}}	0
{{#invoke:String\|find\|abcdef\|abcdefghi}}	0