IBM FileNet P8, 5.2.1 版            

陣列函數

本節包含傳回指定陣列相關資訊之函數的簡要說明。

函數 作用
arraytostring 如果有陣列資料、開頭型樣、結尾型樣及分隔字元,則會傳回字串。
elementcount 傳回陣列中的非空值或非空的元素數目。
nextelement 給定陣列欄位和陣列的索引,會傳回下一個非空白且非空值的項目,如果沒有可用的項目,則傳回零。

elementcount

傳回陣列中的非空值或非空的元素數目(整數)。 請注意,sizeof (<array_field>) 會傳回陣列的現行大小,但陣列中的部分元素可能是空的或空值項目。 如果是附件陣列,空附件會視為空的。
elementcount(array_field)
其中 array_field 是包含來源資料的資料欄位。
一些範例:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100    , , 0) => elementcount(B) = 4; sizeof (B) = 6

請注意,空字串不計入字串陣列中,但每一個數字會計入數值陣列中。也就是說,沒有空的數字。

在處理參與者和附件陣列時,此函數很有用。

nextelement

如果有陣列欄位及陣列的索引,此函數會傳回下一個非空白且非空值的項目,如果沒有可用的項目,則傳回零。如果整數表示式為零,則會傳回第一個非空白且非空值的元素。
nextelement(array_field, index_expr)
其中:
表 1. nextelement 函數之參數及說明的表格
參數 說明
array_field 包含來源資料的資料欄位。
index_expr 開始搜尋時所應使用的索引。如果是零,則會從陣列開頭開始搜尋。
例如,使用陣列
A = ("", , "", "alpha",,"")          B =(0 , , 0 , 100    , , 0)

nextelement (A, 0) = 4
nextelement (A, 4) = 0

nextelement (B, 0) = 1
nextelement (B, 1) = 3
nextelement (B, 3) = 4
nextelement (B, 4) = 6
nextelement (B, 6) = 0
註: 處理程序陣列索引從 1 開始,但索引 0 用來搜尋第一個非空白且非空值元素。

在處理參與者和附件陣列時,此函數很有用。

arraytostring

此函數將陣列資料轉換成字串。
arraytostring(array_field, begin_expr, end_expr, separator_expr)
其中:
表 2. arraytostring 函數的參數及說明
參數 說明
array_field 包含來源資料的資料欄位。
begin_expr 標示陣列開頭的字串。
end_expr 標示陣列結尾的字串。
separator_expr 用來分隔陣列中元素的字串。
比方說,如果有資料欄位 MyStringArray 及內容 {1,2,3},請使用下列指令來傳回字串資料:
  • arraytostring(MyStringArray, "{ ", " }", ",") returns { 1,2,3 }
此函數可用來從 MyXMLField 的 XML 綱目中的資料欄位陣列傳回字串。
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
綱目範例


前次更新: 2016 年 3 月
bpfe003.htm

© Copyright IBM Corp. 2016.