第三十章 Caché 函數大全 $LISTFROMSTRING 函數 第三十章 Caché 函數大全 $LISTFROMSTRING 函數 大綱 描述 參數 示例

第三十章 Caché 函數大全 $LISTFROMSTRING 函數

從字符串創建列表。

大綱

$LISTFROMSTRING(string,delimiter)
$LFS(string,delimiter)

參數

• string 要轉換爲Caché列表的字符串。此字符串包含一個或多個用定界符分隔的元素。分隔符不會成爲結果Caché列表的一部分。
• delimiter 可選-用於分隔字符串中的子字符串（元素）的定界符。將定界符指定爲帶引號的字符串。如果未指定定界符，則默認爲逗號（，）字符。

描述

$LISTFROMSTRING接受包含定界元素的帶引號的字符串並返回列表。列表以不使用分隔符的編碼格式表示數據。因此，列表可以包含所有可能的字符，並且非常適合於位串數據。使用CachéObjectScript $LIST函數處理列表。

參數

string

字符串文字（用引號引起來），數字或計算結果爲字符串的變量或表達式。該字符串可以包含一個或多個用分隔符分隔的子字符串（元素）。字符串數據元素不得包含定界符（或字符串），因爲定界符不包含在輸出列表中。

delimiter

一個字符（或字符串），用於在輸入字符串中定界子字符串。它可以是數字或字符串文字（用引號引起來），變量名或計算結果爲字符串的表達式。

通常，分隔符是指定的字符，在字符串數據中從未使用過，但僅留作分隔符，用作分隔子字符串的分隔符。分隔符也可以是多字符字符串，可以在字符串數據中使用其各個字符。

如果未指定定界符，則默認定界符爲逗號（，）字符。不能將空字符串（“”）指定爲分隔符。嘗試這樣做會導致錯誤。

示例

下面的示例採用由空格分隔的名稱字符串，並創建一個列表：

/// d ##class(PHA.TEST.Function).LISTFROMSTRING()
ClassMethod LISTFROMSTRING()
{
   SET namestring="Deborah Noah Martha Bowie"
   SET namelist=$LISTFROMSTRING(namestring," ")
   WRITE !,"1st element: ",$LIST(namelist,1)
   WRITE !,"2nd element: ",$LIST(namelist,2)
   WRITE !,"3rd element: ",$LIST(namelist,3)
}