Funkcia %StrJoin

Funkcia

Táto funkcia vracia reťazec vytvorený z textových hodnôt stĺpca lokálnej premennej typu Record, spojených znakom oddeľovača.

Deklarácia

TEXT %StrJoin(
   in refToColumn
   ,TEXT in separator
   [,INT in mode := 0
   [,INT in idxFrom := 1
   [,INT in idxTo := Last]]]
 )

Parametre

refToColumn	Odkaz na stĺpec lokálnej premennej typu Record.
separator	Textová hodnota, ktorá oddeľuje jednotlivé hodnoty zo stĺpca vo výslednom reťazci.
mode	Parameter, ktorý definuje chovanie funkcie pri spracovaní neplatnej alebo netextovej hodnoty v riadku stĺpca. (Predvolená hodnota parametra je 0) 0 - Funkcia vráti neplatný string. 1 - Funkcia pracuje s neplatnými/netextovými hodnotami ako s prázdnym stringom a pokračuje v spracovávaní 2 - Funkcia preskočí neplatné/netextové hodnoty a pokračuje v spracovávaní
idxFrom	Index prvého riadka. (Predvolená hodnota parametra je 1)
idxTo	Index posledného riadka. (Predvolená hodnota parametra je index posledného riadka danej lokálnej premennej typu Record)

Popis

Funkcia spája textové hodnoty z rozsahu riadkov pre daný stĺpec lokálnej premennej typu Record do jedného textového reťazca.

Príklad

BEGIN
  RECORD NOALIAS (SD.TEXT_ARR) _arr
  TEXT _txt
  
  REDIM _arr[3]
  _arr[1]^Text := "London"
  _arr[2]^Text := "New York"
  _arr[3]^Text := "Tokyo"
  
  _txt := %StrJoin(_arr^Text, ", ") ; _txt => "London, New York, Tokyo"
  
  REDIM _arr[6]
  _arr[5]^Text := "Paris"
  _arr[6]^Text := "Madrid"
  ; _arr[4]^Text => Invalid String
  
  _txt := %StrJoin(_arr^Text, ", ") ; _txt => Invalid String
  _txt := %StrJoin(_arr^Text, ", ", 0, 5, 6) ; _txt => "Paris, Madrid"
  _txt := %StrJoin(_arr^Text, ", ", 1) ; _txt => "London, New York, Tokyo, , Paris, Madrid"
  _txt := %StrJoin(_arr^Text, ", ", 2) ; _txt => "London, New York, Tokyo, Paris, Madrid"
END

Súvisiace stránky:

Rozšírené funkcie ESL
Argumenty funkcie - typy