Funkcje tekstowe dostępne są z menu Funkcja tekstowa. Działają na właściwościach tekstowych i są przydatne podczas formatowania wyników zapytań związanych z tekstem. Te funkcje są dostępne dla wszystkich dostawców danych z wyjątkiem dostawców rastra, WFS i WMS.
Podczas tworzenia wyrażenia dla elementów geoprzestrzennych, można użyć następujących funkcji tekstowych:
Funkcja | Definicja | Składnia | Przykład |
---|---|---|---|
CONCAT |
Łączy wiele ciągów w jeden. CONCAT pobiera dowolną liczbę argumentów, które mogą być dowolnym typem właściwości, oprócz właściwości Geometria lub Raster. Zwracana wartość korzysta z danych typu Ciąg. Ciąg '\n' jest używany do wstawiania podziału wiersza w wypadku zastosowania stylów standardowych. Ciągu '\P' należy użyć, aby wstawić podział wiersza w wypadku zastosowania stylów rozszerzonych. W tych parametrach jest rozróżniana wielkość liter. Aby uwzględnić statyczne etykiety tekstowe lub powierzchnie, otocz je pojedynczym cudzysłowem. Użycie funkcji Concat z właściwością logiczną spowoduje wygenerowanie wartości 1/0 (a nie prawda/fałsz). |
CONCAT(Właściwość, Właściwość,...) |
CONCAT(Imię, ‘ ‘Nazwisko,’\P’ ‘Adres: ‘, Nazwa_ulicy, ‘ ‘, Numer_domu, ‘ ‘, Przyrostek) To przykładowe wyrażenie spowoduje utworzenie następującej etykiety: John Smith Adres: 123 Maple Street |
INSTR |
Wyszukuje pozycję pierwszego wystąpienia podciągu znaków w innym ciągu. Określ ciąg źródłowy jako pierwszy z argumentów, a następnie wyszukiwany ciąg, jako drugi argument. Zwraca liczbę całkowitą z danymi typu Int64. |
INSTR(Właściwość lub wartość tekstowa, Właściwość lub wartość tekstowa) |
INSTR(Właściciel_działki,'pole') Przykładowe wyrażenie wyszukuje podciąg znaków „pole” w ciągu właściciela działki. Jeśli nazwa właściciela działki to Smithfield, zostanie zwrócona wartość 6. |
LENGTH |
Zwraca liczbę znaków określonego ciągu jako liczbę całkowitą z typem danych Int64. Nie obejmuje pustych znaków kończących. |
LENGTH(Właściwość_tekstowa) |
LENGTH(Imię) Przykładowe wyrażenie wyszukuje liczbę znaków dla właściwości Imię. |
LOWER |
Przekształca tekst w małe litery. Zwracana wartość korzysta z danych typu Ciąg. |
LOWER(Właściwość_tekstowa) |
LOWER(Nazwa_produktu) Przykładowe wyrażenie zmienia nazwę produktu na małe litery (na przykład ELEMENT RURY na element rury). |
LPAD |
Dodaje określone znaki po lewej stronie ciągu. Zwracana wartość korzysta z danych typu Ciąg. LPAD może przyjąć dwa do trzech parametrów. Jeśli nie zostanie określony argument znaku tekstowego, użyty będzie znak spacji. |
LPAD(Właściwość tekstowa, Liczba znaków,'znak tekstowy') |
LPAD(Wysoki_priorytet,3,'*') Przykładowe wyrażenie wyświetli wartość właściwości Wysoki_priorytet (na przykład „Naprawa awarii”) poprzedzonej ***. |
LTRIM |
Przycina znaki od lewej strony ciągu tekstowego. Zwracana wartość korzysta z danych typu Ciąg. |
LTRIM(Właściwość_tekstowa) |
LTRIM(ID_działki) Przykładowe wyrażenie usuwa znaki wiodące z identyfikatorów działek. |
RPAD |
Dodaje określone znaki po prawej stronie ciągu. Zwracana wartość korzysta z danych typu Ciąg. RPAD może przyjąć dwa do trzech parametrów. Jeśli nie zostanie określony argument znaku tekstowego, użyty będzie znak spacji. |
RPAD(Właściwość tekstowa, Liczba znaków,'znak tekstowy') |
RPAD(Kosztowna_naprawa,3,$) Przykładowe wyrażenie wyświetli wartość właściwości Kosztowna_naprawa (na przykład „Całkowita zmiana konstrukcji”) następującej po $$$. |
RTRIM |
Przycina znaki od prawej strony ciągu tekstowego (znaki kończące). Zwracana wartość korzysta z danych typu Ciąg. Użyj funkcji TRIM, aby usunąć znaki wiodące. Zobacz sekcję TRIM. |
RTRIM(Właściwość_tekstowa) |
RTRIM(ID_działki) Przykładowe wyrażenie powoduje usunięcie znaków następujących po identyfikatorze działki. |
SOUNDEX |
Zwraca nazwy w języku angielskim brzmiące jak określony ciąg znaków. Zwracana wartość korzysta z danych typu Ciąg. Podstawowy system RDBMS oblicza wszystkie wyrażenia, w tym funkcję SOUNDEX. Wyniki zwracane przez dostawcę MySQL mogą różnić się od wyników zwracanych przez innych dostawców. |
SOUNDEX(Właściwość_tekstowa) = SOUNDEX('ciąg tekstowy') |
SOUNDEX(Nazwisko) = SOUNDEX('Smith') Przykładowe wyrażenie wyszukuje nazwisko brzmiące podobnie do nazwiska Smith (na przykład „Smythe”). |
SUBSTR |
Wyodrębnia podciąg znaków z ciągu. Jeśli położenie początkowe wynosi 0, jest ono traktowane jako 1. W przypadku określenia położenia początkowego jako wartości ujemnej, wyrażenie odlicza do tyłu od końca ciągu. Zwracana wartość korzysta z danych typu Ciąg. Na przykład SUBSTR('ABCDEFG',-6,4) znajduje BCDE. |
SUBSTR(Właściwość_tekstowa, Położenie początkowe, Długość podciągu znaków) |
SUBSTR(Nazwisko,0,4) |
TRANSLATE |
Zamienia ciąg znaków na inny ciąg znaków. Zwracana wartość korzysta z danych typu Ciąg. Na przykład TRANSLATE('GIS Podręcznik specjalisty C#' ' ''#', '___') zmienia wyświetlany tytuł książki na „GIS_Podręcznik_specjalisty_C_)”. Oryginalny tytuł wymagał dodatkowego pojedynczego cudzysłowu jako znaku zmiany znaczenia. |
TRANSLATE(Właściwość_tekstowa,'z-tekstu','na-tekstu') |
TRANSLATE(Właściwość_komentarza ' ''#', '___') Przykładowe wyrażenie zmienia spacje, znaki cudzysłowu i znaki # na znaki podkreślenia. |
TRIM |
Przycina znaki wiodące z ciągu tekstowego. Użyj funkcji RTRIM, aby usunąć znaki końcowe. Zwracana wartość korzysta z danych typu Ciąg. Można określić dodatkowy argument jako BOTH, LEADING lub TRAILING. Jeśli znak przycięcia nie zostanie określony, domyślnie przyjmowany jest znak spacji. Zobacz sekcję RTRIM. |
TRIM('argument_opcjonalny', Właściwość_tekstowa) |
TRIM(‘końcowy', ID_działki) Przykładowe wyrażenie przycina znaki końcowe z identyfikatora działki. |
UPPER |
Przekształca tekst w wielkie litery. Zwracana wartość korzysta z danych typu Ciąg. |
UPPER(Właściwość_tekstowa) |
UPPER(Właściciel_działki) Przykładowe wyrażenie powoduje wyświetlenie wartości „John McMansion” jako „JOHN MCMANSION”. |