ALINES( ) 函式
將一個字符表達式的或備註字段中的每一行複製到一個數組相應行。
語法
ALINES(ArrayName,cExpression [,ltrim])
返值類型
數值型
參數描述
ArrayName 指定數組的名稱,將字元表達式或備註欄位中的每一行複製到該一個數組中。如果所指定的數組不存在,Visual FoxPro 會自動創建該數組。如果該數組存在, 但是大小不足以容納備註欄位中的每一行,則 Visual FoxPro 自動增加該數組的大小。如果該數組比所需的要大,則 Visual FoxPro 會截短該數組。
cExpression
指定字元表達式或備註欄位,其中包含要複製到數組中的行。如果cExpression 是空字元串或 null 值,會創建一個具有單行的數組,並且該行包含空字元串。
lTrim
指定是否從複製到數組的行中刪除前導和後綴空格。如果 lTrim 為“真”(.T.),則從行中刪除前導和後綴空格。如果 lTrim 為“假” (.F.) 或省略,則不刪除前導和後綴空格。
說明
ALINES()返回數組的行數(或者,同樣地返回字元表達式或備註欄位的行數) 。字元表達式或備註欄位的第一行複製到數組的第一行,字元表達式或備註欄位的第二行複製到數組的第二行, 依次類推。一個換行符 (Chr(10)) 或回車符 (CHR(13)) 表明了一行的結束。也可以使用這些字元的組合 (CHR(10) + CHR(13)或CHR(13) + CHR(10)) 表明一行的結束。ALINES()提供了分析字元表達式或備註欄位中各行的簡單方法。雖然 MLINES() 也用來分析字元表達式或備註欄位,但是 ALINES()更快,並且需要更少的編程。另外,ALINES() 不受 SET MEMOWIDTH 的值的影響。為了將字元表達式或備註欄位中的行複製到數組, 必須有足夠的記憶體。如果記憶體不足,Visual FoxPro 會生成一條錯誤信息。
alines( ) 函式示例
下面的程式在資料庫 testdata 中打開表 employee。 alines( ) 用於複製notes備註型欄位中的行到名為 amyarray 的數組中, 然後顯示數組的內容。
本示例中,alines( ) 返回 1,因為在備註欄位中輸入雇員信息時,句子後沒有按 enter 鍵。
close databases
clear
set talk off
open database (home(2) + 'data\testdata')
use employee && 打開 employee 表?
alines(amyarray,employee.notes) && 顯示 1
? amyarray(1)
