Modulis:String/doc

len

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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}}

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}}

sublength

Piezīme: neizmantot!

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

match

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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:

• Scribunto patterns
• Scribunto Unicode string patterns

Kods	Rezultāts
{{#invoke:String|match|s=Jānis Bērziņš|^[^%s]*}}	Jānis
{{#invoke:String|match|s=abc|^%a*}}	abc
{{#invoke:String|match|s=abc4f|^%a*}}	abc

pos

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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}}
{{#invoke:String|pos|ŠeitIrSimboluVirkne|0}}
{{#invoke:String|pos|ŠeitIrSimboluVirkne|30}}
{{#invoke:String|pos|ŠeitIrSimboluVirkne|-30}}

str_find

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

find

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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

1. lietojums Vikipēdijā latviešu valodā
2. lietojums Vikipēdijā angļu valodā

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