To jest strona dokumentacji dla Moduł:String
Ten moduł jest używany na około 1 500 000 stronach, co stanowi około 316456% wszystkich stron.
Aby uniknąć nadmiernego obciążenia serwera, wszystkie eksperymenty należy przeprowadzać w swoim brudnopisie dla modułów Lua. Przetestowane zmiany powinny być dodawane w jednej edycji. Proszę przedyskutować każdą zmianę przed jej wprowadzaniem.
Osoba dokonująca zmian w tym szablonie powinna być przygotowana do naprawienia niepożądanych efektów ubocznych swoich działań.
Moduł zawiera zestaw funkcji do operacji na ciągach znaków (string).
Można podawać parametry w formie nienazwanej według kolejności z dokumentacji.
| Funkcja
|
Przeznaczenie
|
Zapis
|
Opis parametrów
|
| len
|
Długość ciągu
|
{{#invoke:String|len|s=}}
|
- s - ciąg do zmierzenia
|
| sub
|
Wycina fragment od wybranej pozycji o określonej długości
|
{{#invoke:String|sub|s=|i=|j=}}
|
- s - oryginalny ciąg
- i - pozycja, od której zacząć
- j - pozycja, na której skończyć. Domyślnie do końca.
|
| sublength
|
Wywołuje ustring.sub.
|
{{#invoke:String|sublength|s=|i=|j=}}
|
- s - oryginalny ciąg
- i - pozycja, od której zacząć
- j - pozycja, na której skończyć. Domyślnie do końca.
|
| match
|
Znajdź pasujące
|
{{#invoke:String|match|s=|pattern=|start=|match=|plain=|nomatch=}}
|
- s: Przeszukiwany ciąg
- pattern: Wzór do znalezienia
- start: Odkąd szukać. Pierwszy znak to 1. Domyślnie: 1.
- match: Które wystąpienie zwrócić? Domyślnie:1. Liczba ujemna liczy od końca.
- plain: 1 jeżeli czysty tekst, 0 dla wyrażeń regularnych (domyślnie)
- nomatch: Jeśli nie znaleziono dopasowania, zwrócona zostanie wartość tego parametru, zamiast komunikatu błędu.
|
| pos
|
Pobierz N znak ciągu
|
{{#invoke:String|pos|target=|pos=}}
|
- target - ciąg do przeszukania
- pos - numer pozycji znaku
|
| str_find
|
Wywołuje mw.ustring.find
|
{{#invoke:String|str_find|source=|target=}}
|
- source: Przeszukiwany ciąg
- target: Wyszukiwany ciąg
|
| find
|
Zwraca pozycję określonego fragmentu w przeszukiwanym ciągu
|
{{#invoke:String|find|source=|target=|start=|plain=}}
|
- source: Przeszukiwany ciąg
- target: Wyszukiwany ciąg
- start - od której pozycji wyszukiwać
- plain - 1 jeżeli czysty teskt, 0 dla wyrażeń regularnych
|
| replace
|
Zamiana tekstu w ciągu
|
{{#invoke:String|replace|source=|pattern=|replace=|count=|plain=}}
|
- source - Oryginalny ciąg
- pattern - Wyszukiwany wzorzec
- replace - Zmień na...
- count - Ogranicz zamianę do X pierwszych wystąpień
- plain - 1 jeżeli czysty tekst, 0 dla wyrażeń regularnych
|
| rep
|
Powtórz ciąg kilka razy. Wywołuje string.rep.
|
{{#invoke:String|rep|string|ile}}
|
- Ciąg do powtórzenia
- Ile razy
|
| join
|
Łączy teksty podane jako parametry w jeden ciąg za pomocą łącznika.
|
{{#invoke:String|join|łącznik|parametr1|parametr2|...}}
|
- łącznik - element umieszczany pomiędzy kolejnymi parametrami
- parametr1, parametr2, ... - kolejne argumenty do połączenia
|