Funkcje do przetwarzania, wyszukiwania i formatowania tekstu. Można je wypróbować w edytorze wyrażeń w ramach okresu próbnego.
len
(text) Zwraca liczbę znaków w tekście.
| Parametry | | text | string | Tekst do zmierzenia | |
| Zwracana wartość | liczba |
| Przykłady | |
left
(text, count) Zwraca pierwsze N znaków tekstu.
| Parametry | | text | string | Tekst źródłowy | | count | number | Liczba znaków do pobrania | |
| Zwracana wartość | ciąg znaków |
| Przykłady | left("ProcessMind", 7) → Process |
| Zobacz także | |
right
(text, count) Zwraca ostatnie N znaków tekstu.
| Parametry | | text | string | Tekst źródłowy | | count | number | Liczba znaków do pobrania | |
| Zwracana wartość | ciąg znaków |
| Przykłady | right("ProcessMind", 4) → Mind |
| Zobacz także | |
mid
(text, start, count) Zwraca fragment tekstu ze środka, zaczynając od wskazanej pozycji (liczonej od 1) i pobierając określoną liczbę znaków.
| Parametry | | text | string | Tekst źródłowy | | start | number | Pozycja początkowa (liczona od 1) | | count | number | Liczba znaków do pobrania | |
| Zwracana wartość | ciąg znaków |
| Przykłady | mid("ProcessMind", 8, 4) → Mind mid("Hello World", 1, 5) → Hello |
| Zobacz także | |
lower
(text) Zamienia wszystkie litery w tekście na małe.
| Parametry | | text | string | Tekst do przekształcenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | |
| Zobacz także | |
upper
(text) Zamienia wszystkie litery w tekście na wielkie.
| Parametry | | text | string | Tekst do przekształcenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | |
| Zobacz także | |
proper
(text) Zapisuje tekst wielkimi literami na początku każdego wyrazu.
| Parametry | | text | string | Tekst do przekształcenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | proper("hello world") → Hello World proper("HELLO WORLD") → Hello World |
| Zobacz także | |
trim
(text) Usuwa białe znaki z początku i końca tekstu.
| Parametry | | text | string | Tekst do oczyszczenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | |
| Zobacz także | |
trimStart
(text) Usuwa białe znaki z początku tekstu.
| Parametry | | text | string | Tekst do oczyszczenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | trimStart(" hello") → hello |
| Zobacz także | |
trimEnd
(text) Usuwa białe znaki z końca tekstu.
| Parametry | | text | string | Tekst do oczyszczenia | |
| Zwracana wartość | ciąg znaków |
| Przykłady | trimEnd("hello ") → hello |
| Zobacz także | |
replace
(text, search, replacement) Zastępuje każde wystąpienie wyszukiwanego tekstu innym tekstem.
| Parametry | | text | string | Tekst źródłowy | | search | string | Tekst do znalezienia | | replacement | string | Tekst zastępujący | |
| Zwracana wartość | ciąg znaków |
| Przykłady | replace("Hello World", "World", "ProcessMind") → Hello ProcessMind replace("a-b-c", "-", "_") → a_b_c |
concat
(text1, text2, ...?) Łączy dwa lub więcej tekstów.
| Parametry | | text1 | string | Pierwszy ciąg znaków | | text2 | string | Drugi ciąg znaków | | ... (opcjonalny) | string | Dodatkowe teksty, maksymalnie 6 łącznie | |
| Zwracana wartość | ciąg znaków |
| Przykłady | concat("Hello", " ", "World") → Hello World |
| Uwagi | Do łączenia tekstów można też użyć operatora +. |
contains
(text, search) Sprawdza, czy tekst zawiera inny tekst.
| Parametry | | text | string | Tekst do przeszukania | | search | string | Tekst do znalezienia | |
| Zwracana wartość | wartość logiczna |
| Przykłady | contains("ProcessMind", "Mind") → true contains("Hello", "xyz") → false |
| Zobacz także | |
startsWith
(text, prefix) Sprawdza, czy tekst zaczyna się od podanego prefiksu.
| Parametry | | text | string | Tekst do sprawdzenia | | prefix | string | Szukany prefiks | |
| Zwracana wartość | wartość logiczna |
| Przykłady | startsWith("ProcessMind", "Process") → true |
| Zobacz także | |
endsWith
(text, suffix) Sprawdza, czy tekst kończy się podanym sufiksem.
| Parametry | | text | string | Tekst do sprawdzenia | | suffix | string | Szukany sufiks | |
| Zwracana wartość | wartość logiczna |
| Przykłady | endsWith("ProcessMind", "Mind") → true |
| Zobacz także | |
indexOf
(text, search) Zwraca pozycję pierwszego wystąpienia fragmentu tekstu, liczoną od 1. Jeśli go nie znajdzie, zwraca 0.
| Parametry | | text | string | Tekst do przeszukania | | search | string | Tekst do znalezienia | |
| Zwracana wartość | liczba |
| Przykłady | indexOf("ProcessMind", "Mind") → 8 indexOf("Hello", "xyz") → 0 |
| Zobacz także | |
find
(search, text) Alias funkcji indexOf. Zwraca pozycję pierwszego wystąpienia fragmentu tekstu, liczoną od 1.
| Parametry | | search | string | Tekst do znalezienia | | text | string | Tekst do przeszukania | |
| Zwracana wartość | liczba |
| Przykłady | find("Mind", "ProcessMind") → 8 |
| Uwagi | Zwróć uwagę, że kolejność parametrów jest odwrotna niż w funkcji indexOf. |
| Zobacz także | |
padLeft
(text, length, char?) Dodaje znaki z lewej strony tekstu, aż osiągnie on wskazaną długość.
| Parametry | | text | string | Tekst do uzupełnienia | | length | number | Docelowa długość | | char (opcjonalny) | string | Znak do uzupełnienia (domyślny: " " (spacja)) | |
| Zwracana wartość | ciąg znaków |
| Przykłady | padLeft("42", 5, "0") → 00042 |
| Zobacz także | |
padRight
(text, length, char?) Dodaje znaki z prawej strony tekstu, aż osiągnie on wskazaną długość.
| Parametry | | text | string | Tekst do uzupełnienia | | length | number | Docelowa długość | | char (opcjonalny) | string | Znak do uzupełnienia (domyślny: " " (spacja)) | |
| Zwracana wartość | ciąg znaków |
| Przykłady | padRight("Hi", 5, ".") → Hi... |
| Zobacz także | |
Powiązane tematy