Ovo je dokumentacijska podstranica za Modul:String. Sadrži informacije o uporabi, kategorijama i ostalom sadržaju koji nije dio izvorne stranice. |
Radovi u tijeku! |
---|
Jedan vrijedni suradnik upravo radi na ovom članku! |
Modul pruža osnovne operacije rada s tekstom.
Pogreške u sintaksi modula postavit će stranicu s pogreškom u kategoriju Kategorija:Pogreške u modulu String.
Sintaksa poziva: {{#invoke:string|funkcija|parametri}}
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 pogreške, umjesto poruke o pogrešci prikazat će se prazni string ("").
- error_category - ako se dogodi pogreš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 pogreške, stranica se neće postaviti u kategoriju Kategorija:Pogreške u modulu String.
len
vraća duljinu stringa zadanog parametrom
{{#invoke:string|len|abcd}}
-> 4- Razmaci na početku i kraju se ubrajaju u znakove:
{{#invoke:string|len| abcd }}
-> 8
- Ako parametar sadrži znak jednakosti, potrebno je upotrijebiti parametar s:
{{#invoke:string|len|s=ab=cd}}
-> 5
- Pri pozivu parametrom s, razmaci na početku i kraju se ne ubrajaju:
{{#invoke:string|len|s= ab=c d }}
-> 6
sub
vraća znakove između zadane početne i krajnje pozicije
{{#invoke:String|sub|puni_tekst|početna_pozicija|krajnja_pozicija}}
- ili
{{#invoke:String|sub|s=puni_tekst|i=početna_pozicija|j=krajnja_pozicija}}
- Primjeri:
- Negativna vrijednost parametara interpretira se kao brojenje od kraja
sublength
vraća znakove definirane početnom pozicijom i duljinom
{{#invoke:String|sublength|puni_tekst|početna_pozicija|duljina}}
- ili
{{#invoke:String|sublength|s=puni_tekst|i=početna_pozicija|len=duljina}}
- Primjeri:
match
vraća dio teksta koji se poklapa sa zadanim uzorkom
{{#invoke:String|match|puni_tekst|uzorak|početna pozicija|broj poklapanja|tekst ili regex|poruka ako nema poklapanja}}
- ili
{{#invoke:String|match|s=puni_tekst|pattern=uzorak|start=početna pozicija|match=broj poklapanja|plain=tekst ili regex|nomatch=poruka ako nema poklapanja}}
- 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 "String Module Error: Match not found"
- Primjeri:
{{#invoke:String|match|abc123def456|%d+}}
→ 123{{#invoke:String|match|s=abc123def456|pattern=%d+}}
→ 123{{#invoke:String|match|abc123def456|%d+|5}}
→ 23{{#invoke:String|match|s=abc123def456|pattern=%d+|start=6}}
→ 3{{#invoke:String|match|s=abc123def456|pattern=%d+|start=6|match=2}}
→ 456{{#invoke:String|match|s=abc123%d+|pattern=%d+}}
→ 123{{#invoke:String|match|s=abc123%d+|pattern=%d+|plain=true}}
→ %d+{{#invoke:String|match|s=abc|pattern=%d}}
→ String Module Error: Match not found{{#invoke:String|match|s=abc|pattern=%d|nomatch=Nisu pronađene brojčane vrijednosti}}
→ Nisu pronađene brojčane vrijednosti{{#invoke:String|match|s=abc|pattern=%d|ignore_errors=true}}
→{{#invoke:String|match|s=0012001200|pattern=0*(%d*)}}
→ 12001200
pos
vraća jedan znak sa zadane pozicije
{{#invoke:String|pos|puni tekst|broj pozicije}}
- ili
{{#invoke:String|pos|target=puni tekst|pos=broj pozicije}}
- Napomene:
- Negativna vrijednost parametra interpretira se kao brojenje od kraja umjesto od početka
- Primjeri
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:String|find|puni_tekst|uzorak|početna pozicija|tekst ili regex}}
- ili
{{#invoke:String|find|source=puni_tekst|target=uzorak|start=početna pozicija|plain=tekst ili regex}}
- 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:String|find|abc123def|12}}
→ 4{{#invoke:String|find|source=abc123def|target=12}}
→ 4{{#invoke:String|find|source=abc123def|target=pqr}}
→ 0{{#invoke:String|find|abc123def|123}}
→ 4{{#invoke:String|find|source=abc123def|target= 123}}
→ 4{{#invoke:String|find|source=abc123def|target=%d|start=3|plain=false}}
→ 4