第三十章 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)
}