Moduł:String/opis
Moduł zawiera zestaw funkcji do operacji na ciągach znaków (String).
Można podawać parametry w formie nienazwanej lub nazwanej, według kolejności z dokumentacji.
Moduł łańcuchów, a korzystające z niej szablony też tego samego rodzaju
[edytuj]Nazwy funkcji angielskie mają parametry o nazwach angielskie, a polskie polskie. Przykłady z polskimi nazwami funkcji modułu {{#invoke:String}} można znaleźć w dokumentacji {{Długość}}, tylko zamiast nazw odpowiednich polskich szablonów powinno się pisać {{#invoke:String|nazwa funkcji polska|...}}, gdzie zamiast: nazwa funkcji polska, powinno się pisać nazwy funkcji w tej dokumentacji, a gdzie jest tam trzykropek, należy napisać parametry też według tej dokumentacji, ale polskie, które pokrywają się dokładnie z nazwami argumentów w podanej dokumentacji, tylko należy pamiętać, że tam indeksacja parametrów jest po kolei, a tu indeksacja też jest po kolei, ale względem parametrów nienazwanych, i dlatego tutaj parametry należy podawać po kolei, a tam można podawać w dowolnej kolejności.
Opis funkcji szablonu i jego parametrów, tylko w formie nazwanej, i przykłady
[edytuj]| Funkcja | Przeznaczenie | Zapis | Opis parametrów |
|---|---|---|---|
| len, długość | Długość ciągu | {{#invoke:String|len|s=}}, {{#invoke:String|długość|ciąg=}} przykład: {{#invoke:String|len|s=abc}} → 3 |
|
| sub, subciąg | Wycina fragment od wybranej pozycji o określonej długości | {{#invoke:String|sub|s=|i=|j=}}, {{#invoke:String|subciąg|ciąg=|od=|do=}} przykład: {{#invoke:String|sub|s=1234567|i=2|j=4}} → 234 |
|
| sublength, subciąg2 | Wywołuje mw.ustring.sub. | {{#invoke:String|sublength|s=|i=|len=}}, {{#invoke:String|subciąg2|ciąg=|od=|długość=}} przykład: {{#invoke:String|sublength|s=1234567|i=2|len=3}} → 345 |
|
| match, dopasuj | Znajdź pasujące | {{#invoke:String|match|s=|pattern=|start=|match=|plain=|nomatch=}}, {{#invoke:String|dopasuj|ciąg=|wzór=|od=|które=|jak=|przeciwnie=}} przykłady: {{#invoke:String|match|s=123a45b67|pattern=%a+|match=2}} → b {{#invoke:String|match|s=123a45b67|pattern=%a+|match=-1}} → b {{#invoke:String|match|s=123%a+45b67|pattern=%a+|match=1|plain=1}} → %a+ {{#invoke:String|match|s=1234567|pattern=%a+|match=2|plain=1|nomatch=nie}} → nie {{#invoke:String|match|s=123a45b67|pattern=%a+|start=5}} → b |
|
| pos, pobierz | Pobierz N znak ciągu | {{#invoke:String|pos|target=|pos=}}, {{#invoke:String|pobierz|ciąg=|pozycja=}} przykład: {{#invoke:String|pos|target=1234567|pos=5}} → 5 |
|
| str_find, wyszukaj | Wywołuje mw.ustring.find | {{#invoke:String|str_find|source=|target=}}, {{#invoke:String|wyszukaj|ciąg=|cel=}} przykład: {{#invoke:String|str_find|source=123s456|target=s}} → 4 |
|
| find, znajdź | Zwraca pozycję określonego fragmentu w przeszukiwanym ciągu | {{#invoke:String|find|source=|target=|start=|plain=}}, {{#invoke:String|znajdź|ciąg=|cel=|od=|jak=}} przykłady: {{#invoke:String|find|source=123%s456|target=%a|plain=0}} → 5 {{#invoke:String|find|source=123%s45%a6|target=%a|start=6}} → 8 |
|
| replace, zastąp | Zamiana tekstu w ciągu | {{#invoke:String|replace|source=|pattern=|replace=|count=|plain=}}, {{#invoke:String|zastąp|ciąg=|wzór=|zamień=|ile=|jak=}} przykłady: {{#invoke:String|replace|source=123s45s6|pattern=%a|replace=q|plain=0}} → 123q45q6 {{#invoke:String|replace|source=123s45s6|pattern=%a|replace=q|count=1|plain=0}} → 123q45s6 {{#invoke:String|replace|source=123%a45%a6|pattern=%a|replace=q|count=1}} → 123q45%a6 |
|
| rep, powtórz | Powtórz ciąg klika razy. Wywołuje string.rep. | {{#invoke:String|rep|source=|count=}}, {{#invoke:String|powtórz|ciąg=|ile=}} przykład: {{#invoke:String|rep|source=123s456|count=2}} → 123s456123s456 |
|
| join, łącz | Łączy teksty podane jako parametry w jeden ciąg za pomocą łącznika. | {{#invoke:String|join|hyphen=|parameter=|parameter 2=|...}}, {{#invoke:String|łącz|łącznik=|parametr=|parametr 2=|...}} przykład: {{#invoke:String|join|hyphen=.|parameter=1|parameter 2=2|1=3|parameter 4=4}} → 1.2.3.4 |
|