Modul:String/doc

Modul pruža osnovne operacije rada s tekstom.

Pogrješke u sintaksi modula postavit će stranicu s pogrješkom u kategoriju Kategorija:Pogreške u modulu String.

Sintaksa poziva: {{#invoke:}}

Funkcije

globalni parametri

U svakoj od nižih funkcija možete koristiti i parametre:

ignore_errors - ako je vrijednost postavljena na true ili 1, ako dođe do pogrješke, umjesto poruke o pogrješci prikazat će se prazni string ("").

error_category - ako se dogodi pogrješka, stranica će biti postavljena u kategoriju zadanu ovim parametrom, umjesto u Kategorija:Pogreške u modulu String.

no_category - ako je vrijednost postavljena na true ili 1, ako dođe do pogrješke, stranica se neće postaviti u kategoriju Kategorija:Pogreške u modulu String.

len

vraća duljinu stringa zadanog parametrom

{{#invoke:}} -> 4

Razmaci na početku i kraju se ubrajaju u znakove:

{{#invoke:}} -> 8

Ako parametar sadrži znak jednakosti, potrebno je upotrijebiti parametar s:

{{#invoke:}} -> 5

Pri pozivu parametrom s, razmaci na početku i kraju se ne ubrajaju:

{{#invoke:}} -> 6

sub

vraća znakove između zadane početne i krajnje pozicije

{{#invoke:}}

ili

{{#invoke:}}

Primjeri:

{{#invoke:}} → abcdefghi

{{#invoke:}} → abcdefghi

{{#invoke:}} → cdefghi

{{#invoke:}} → cdefghi

{{#invoke:}} → cd

{{#invoke:}} → cd

Negativna vrijednost parametara interpretira se kao brojenje od kraja

{{#invoke:}} → ghi

{{#invoke:}} → bcdefg

sublength

vraća znakove definirane početnom pozicijom i duljinom

{{#invoke:}}

ili

{{#invoke:}}

Primjeri:

{{#invoke:}} → abcdefghi

{{#invoke:}} → defghi

{{#invoke:}} → defg

match

vraća dio teksta koji se poklapa sa zadanim uzorkom

{{#invoke:}}

ili

{{#invoke:}}

gdje je

• s - puni tekst u kojem tražimo uzorak
• pattern - uzorak ili string koji tražimo u punom tekstu
• start - indeks u punom tekstu od kojeg započinjemo pretragu [zadano 1]
• match - ako imamo isto poklapanje više puta u tekstu, definira broj poklapanja kojeg vraćamo (npr. broj 2 za drugo poklapanje od početka). Ako se unese negativan broj, funkcija tada broji od kraja teksta (npr. -1 vraća zadnje poklapanje od početka) [zadano 1]
• plain - definira oblik uzorka: vrijednost true shvaća uzorak kao čisti tekst, dok vrijednost false shvaća uzorak kao inačicu regularnog izraza koji koristi jezik Lua. Pogledajte detalje ovdje
• nomatch - definira vrijednost ili tekst ako uzorak nije pronađen. Ako ništa nije zadano, vraća ""

Primjeri:

{{#invoke:}} → 123

{{#invoke:}} → 123

{{#invoke:}} → 23

{{#invoke:}} → 3

{{#invoke:}} → 456

{{#invoke:}} → 123

{{#invoke:}} → %d+

{{#invoke:}} →

{{#invoke:}} → Nisu pronađene brojčane vrijednosti

{{#invoke:}} →

{{#invoke:}} → 12001200

pos

vraća jedan znak sa zadane pozicije

{{#invoke:}}

ili

{{#invoke:}}

Napomene:

Negativna vrijednost parametra interpretira se kao brojenje od kraja umjesto od početka

Primjeri

{{#invoke:}} → d

{{#invoke:}} → c

{{#invoke:}} →

str_find

funkcija je dostupna zbog nazadne kompatibilnosti s postojećim kodom, no ne preporuča se njeno korištenje. Umjesto nje molim koristite funkciju find opisanu niže.

find

vraća poziciju teksta koji se poklapa sa zadanim uzorkom

{{#invoke:}}

ili

{{#invoke:}}

gdje je

• source - puni tekst u kojem tražimo uzorak
• target - uzorak ili string koji tražimo u punom tekstu
• start - indeks u punom tekstu od kojeg započinjemo pretragu [zadano 1]
• plain - definira oblik uzorka: vrijednost true shvaća uzorak kao čisti tekst, dok vrijednost false shvaća uzorak kao inačicu regularnog izraza koji koristi jezik Lua. Pogledajte detalje ovdje

Primjeri:

{{#invoke:}} → 4

{{#invoke:}} → 4

{{#invoke:}} → 0

{{#invoke:}} → 4

{{#invoke:}} → 4

{{#invoke:}} → 4