9.5 WMLBrowser库及其函数

9.5  WMLBrowser库及其函数
WMLBrowser库提供了使用WMLScript操作WML卡片及WML浏览器的各种功能函数，这些函数为WMLScript和WML的结合使用提供了很好的支持。不过，如果所用系统不支持WML浏览器，或WMLScript的解释器不是由WML浏览器所激活的，那么WMLBrowser库的所有函数均不能进行有效的操作和处理，只能返回无效值invalid。

WMLBrowser库函数主要包括getCurrentCard、getVar、go、newContext、prev、refresh和setVar函数，下面我们就详细介绍这些函数的功能与用法。

9.5.1  getVar函数
getVar函数用于获取和返回给定变量名的变量值，该变量名由参数name给定，变量名必须遵循WML有关变量命名的语法和规定。如果参数指定的变量不存在，那么函数就会返回空字符串。getVar函数的语法格式如下：

WMLBrowser.getVar(name)

其中的参数name必须是字符串形式表示的变量名，变量值也将以字符串的形式返回。如果变量名的语法不正确，那么函数就会返回无效值invalid。

例如，在下面的几行程序中，变量name被赋值"Good!"，所以当使用getVar函数测试它的变量值的时候，会得到"Good!"的结果。

var name = "Good!";

var a = WMLBrowser.getVar("name");                      // 返回变量name的值，故a = "Good!"

9.5.2  setVar函数
setVar函数的功能是，在当前浏览器运行的程序中，就给定两个参数name和value进行检验和操作，如果name参数代表的变量名确实存在，那么就将value参数代表的变量值赋给name参数代表的变量，然后返回true；否则，就不赋值，同时返回false。setVar函数的语法格式如下：

WMLBrowser.setVar(name, value)

其中参数name和value所代表的变量名及变量值都必须符合WML的语法规定，变量值必须是XML合法的CDATA型数据。如果给定的变量名不符合语法规定或者数值类型不正确，那么函数就会返回无效值invalid。