Dokumentace/Výpočetní funkce/TEXTJOIN
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate
Název funkce:
TEXTJOIN
Kategorie:
Text
Shrnutí:
Sloučí více textových řetězců do jednoho řetězce a mezi jednotlivé podřetězce vloží oddělovače.
Funkce TEXTJOIN je příbuzná funkcím CONCAT a CONCATENATE, ale poskytuje navíc možnost zahrnout do spojeného řetězce oddělovače.
Syntaxe:
TEXTJOIN(Oddělovač, Přeskočit prázdné buňky, Řetězec 1 [; Řetězec 2 [; … ;[ Řetězec 253 ]]])
Vrátí:
Vrátí textový řetězec vytvořený spojením argumentů řetězce od konce ke konci s oddělovači mezi jednotlivými podřetězci.
Argumenty:
Oddělovač je textový řetězec (v uvozovkách), číslo, odkaz na buňku, odkaz na rozsah buněk nebo řádkové pole řetězců (v kulatých závorkách '{' a '}'). Oddělovač určuje text, který se vloží mezi každou dvojici zřetězených podřetězců.
Přeskočit prázdné buňky určuje, zda se prázdné buňky / řetězce mají zahrnout (0 nebo FALSE) nebo ignorovat (jakákoli jiná hodnota). Pokud je nastavena hodnota 0 nebo FALSE pro zahrnutí prázdných buněk / řetězců, pak vrácený řetězec může obsahovat sousední oddělovače.
Řetězec 1 je textový řetězec (v uvozovkách), číslo, odkaz na buňku, odkaz na rozsah buněk nebo řádkové pole řetězců (v kulatých závorkách '{' a '}'). Řetězec 1 určuje první řetězec nebo řetězce, které se mají spojit.
String 2 až String 253 jsou podobné jako String 1, ale určují další řetězce, které mají být spojeny.
- Pokud Oddělovač určuje více řetězců (např. rozsah buněk nebo vložené pole), počet oddělovačů nemusí být stejně velký jako počet řetězců, které mají být zřetězeny. Pokud existuje více oddělovačů než řetězců ke zřetězení, nebudou použity všechny oddělovače. Pokud existuje méně oddělovačů než řetězců, které mají být zřetězeny, budou oddělovače znovu použity cyklickým způsobem.
- Pokud Přeskočit prázdné buňky není číselné, pak TEXTJOIN hlásí #VALUE! chyba.
- Když je zadán rozsah buněk, buňky se procházejí řádek po řádku (shora dolů). To platí jak pro argument Oddělovač, tak pro argumenty Řetězec 1 až po Řetězec 253.
- Délka vráceného řetězce je omezena na méně než 256 * (1024)2 znaků. Pokud by předané argumenty způsobily překročení tohoto limitu, TEXTJOIN hlásí chybu přetečení řetězce (Chyba:513).
Další detaily:
Tato funkce není požadavkem ODF 1.2, ale je kompatibilní s funkcí TEXTJOIN aplikace Microsoft Excel.
Příklady:
| Vzorec | Popis | Vrátí |
|---|---|---|
| =TEXTJOIN(" "; 1; "Here"; "comes"; "the"; "sun") | Zde funkce spojí čtyři řetězcové argumenty a každou dvojici oddělí mezerou. V tomto příkladu není přesná hodnota argumentu Přeskočit prázdné buňky důležitá, protože se nespojují žádné prázdné řetězce. | Tady přichází slunce |
| =TEXTJOIN(B1; C1; D1; D2; D3; D4) kde buňka B1 obsahuje řetězec "-", buňka C1 obsahuje hodnotu 1 a buňky D1 až D4 obsahují řetězce "Tady", "přichází", "the “, „slunce“. | Zde funkce spojí čtyři řetězcové argumenty (předané odkazem na buňku) a každou dvojici oddělí pomlčkou (rovněž předanou odkazem na buňku). V tomto příkladu není přesná hodnota argumentu Přeskočit prázdné buňky (opět předávaného odkazem na buňku) důležitá, protože se nespojují žádné prázdné řetězce. | Tady-přichází-slunce |
| =TEXTJOIN(", "; 0; "John Doe"; ""; "23 High Street"; "Some Town"; "Some City") | Zde funkce spojí řetězcové argumenty a každou dvojici oddělí dvouznakovým oddělovačem (čárka a mezera). Pokud je argument Přeskočit prázdné buňky nastaven na 0, TEXTJOIN neignoruje prázdné řetězce. Proto se ve vráceném řetězci objeví dva sousední oddělovače mezi "John Doe" a "23 High Street". | John Doe, , 23 High Street, Some Town, Some City |
| =TEXTJOIN(", "; 1; "John Doe"; ""; "23 High Street"; "Some Town"; "Some City") | Tento příklad je podobný předchozímu příkladu s tím rozdílem, že argument Skip Empty již není nastaven na 0, a proto se mezi "John Doe" a "23 High Street" neobjeví další oddělovač. | John Doe, 23 High Street, Some Town, Some City |
| =TEXTJOIN({"+","-","="}; 0; {9,7,5,11}) | Zde jsou oddělovače definovány v řádkovém poli řetězců, zatímco řetězce, které mají být spojeny, jsou definovány v řádkovém poli čísel. Oddělovače se používají postupně a přesná hodnota argumentu Skip Empty není důležitá, protože neexistují žádné prázdné řetězce. | 9+7-5=11 |
| =TEXTJOIN(E1:F2, 0, A1:C3), kde buňky E1, F1, E2 a F2 obsahují oddělovací řetězce " + ", " - ", " * " a " / ". Buňky A1 až C3 obsahují řetězec představující adresu buňky, takže buňka A1 obsahuje "A1", buňka B2 obsahuje "B2" atd. | Tento příklad slouží k demonstraci toho, jak se TEXTJOIN chová, když jsou oddělovače a řetězce, které mají být spojeny, zadány jako rozsahy buněk. Buňky obsahující oddělovací řetězce jsou procházeny řádek po řádku, shora dolů, a tento cyklus se opakuje tak často, jak je třeba. Řetězce, které se mají spojit, se rovněž procházejí po řádcích shora dolů. V tomto příkladu není přesná hodnota argumentu Přeskočit prázdné buňky důležitá, protože v oblasti A1:C3 nejsou žádné prázdné buňky. | A1 + B1 - C1 * A2 / B2 + C2 - A3 * B3 / C3 |
Související funkce LibreOffice:
ODF standard:
Nic
Související (nebo podobné) funkce Excelu:
TEXTJOIN