ubound() 是 JavaScript 中一個容易被忽略的方法,作用是回傳 VBArray 在指定維度上所使用到的最大索引值。
safeArray.ubound(dimension)
參數說明:
· safeArray:必選,一個 VBArray 物件
· dimension:可選,要查詢索引上界的維度。若省略,會預設當作第 1 維處理
· 若 VBArray 為空,方法回傳 undefined
· 若 dimension 大於 VBArray 的維數,或為負數,會拋出「下標越界」錯誤
以下例子分三部分:先用 VBScript 建立一個安全陣列,再用 JScript 讀取維數與各維上界,最後在 body 中呼叫執行。
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
k = k + 1
Next
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vba)
{
var i, s;
var a = new VBArray(vba);
for (i = 1; i <= a.dimensions(); i++)
{
s = "The upper bound of dimension ";
s += i + " is ";
s += a.ubound(i) + ".<br>";
return(s);
}
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT language="jscript">
document.write(VBArrayTest(CreateVBArray()));
</SCRIPT>
</BODY>
需要提醒的是,VBArray 屬於早期 JScript 與 ActiveX 環境的產物,僅在支援它的舊版 IE 中可用,現代專案幾乎不會再使用,閱讀時當作歷史知識即可。