管理与程序设计指南

调用 Net.Data 内部函数

Net.Data 提供了大量的内部函数来简化 Web 页面的开发。这些函数已经由 Net.Data 定义好了, 因此不需要再对它们进行定义。您可以象调用其他函数一样调用这些函数。

图 23显示了 Net.Data 内部函数和宏是如何相互作用的。

图 23. Net.Data 内部函数


Net.Data 内部函数

根据前缀的不同,内部函数可以三种方式返回它们的结果:

有些内部函数并不具有每一类型。要确定某个特定内部函数具有的类型,参见 Net.Data 参考中的 Net.Data 内部函数章节。

以下章节提供了 Net.Data 内部函数的一个高级概述。使用这些函数可以执行通用、数学、 字符串、字处理或表格处理功能。 参见 Net.Data 参考以获取每个函数的语法说明和示例。这其中的某些函数需要变量在使用 之前先进行设置,或者必须在特定的上下文中使用。并非所有的操作系统都支持每个内部函数。参见 Net.Data 参考以确定您的操作系统支持哪些函数。

通用函数

这个函数集合通过改变数据或访问系统服务来帮助您开发 Web 页面。您可以用它们 来发送邮件、处理 HTTP cookie、生成 HTML 转换代码,并从系统中获取其他有用信息。

例如,要指定 Net.Data 在发生某个特定的情况时应退出宏,而不处理剩下的宏, 可以使用 DTW_EXIT 函数:

%HTML(cache_example) {
 
<html>
 <head>
 <title>This is the page title</title>
 </head>
 <body>
 <center>
 <h3>This is the Main Heading</h3>
 <!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
 <! Joe Smith sees a very short page                   !>
 <!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
 %IF (customer == "Joe Smith")
 </body>
</html>
 
@DTW_EXIT()
 
%ENDIF
 
...
 
 </body>
</html>
 %}

另一个有用的函数是 DTW_URLESCSEQ 函数,它用转换值替换 URL 中不允许的字符。例如,如果输入变量 string1 等 于 "Guys & Dolls",那么 DTW_URLESCSEQ 将为输出变量赋值 "Guys%20%26%20Dolls"

数学函数

这些函数执行数学运算,使您能够计算或改变数字数据。除了标准的数学运算以外, 您还可以执行按模除法、指定结果精度并使用科学记数法。

例如,函数 DTW_POWER 将它第一个参数的值提高为第二个参数的平方并返回结果, 如下面的示例中所示:

@DTW_POWER("2", "-3", result)

DTW_POWER 在变量 result 中 返回 ".125"

字符串函数

这些函数可以让您处理字符串中的字符。您可以更改字符串的大小写、插入或删除字符、 给另一个变量指定字符串值、增加其他有用的函数。

例如,您可以使用 DTW_ASSIGN 将一个输入变量的值赋给输出变量。同样可以使用这个函数在宏中更改一个变量。在下面的示例中,变量 RC 被赋值为 0。

 @DTW_ASSIGN(RC, "0")

其他字符串函数包括 DTW_CONCAT (用于连接字符串)、DTW_INSERT (在特定的位置插入字符串)以及 许多其他字符串处理函数。

字处理函数

这些函数可以让您处理字符串中的单词。这些函数大部分和字符串函数以类似的方式作用, 但它们是对整个单词进行作用。例如,它们可以让您计数一个字符串中的单词个数、删除单词、 在字符串中搜索某个单词。

例如,使用 DTW_DELW0RD 来从一个字符串中删除指定数目的单词:

@DTW_DELWORD("Now is the time", "2", "2", result)

DTW_DELWORD 返回字符串 "Now time"

其他字处理函数包括 DTW_WORDLENGTH (返回单词中的字符个数)、DTW_WORDPOS (返回一个 单词在字符串中的位置)。

表格函数

您可以使用这些函数来生成报告或表格(这些报告或表格使用 Net.Data 表格变量中 的数据)。您还可以使用这些函数来创建 Net.Data 表格,处理和检索那些表格中的值。表格变量中包含了 一系列值以及相关的列名。它们提供了一种便利的方式将一组值传递给 一个函数。

例如,DTW_TB_APPENDROW 在表格后追加一行。在下面的示例中,Net.Data 在 表格 myTable 后面追加了十行:

@DTW_TB_APPENDROW(myTable, "10")

另外,DTW_TB_DUMPH 返回一个宏表格变量的内容(包括在 <pre></pre> 标记中), 表格中的每一行显示在不同的行中。而 DTW_TB_CHECKBOX 从宏表格变量返回一个多个 HTML 校验框输入标记。

平面文件函数

使用平面文件接口 (FFI) 可以打开、读取和处理平面文件源(文本文件)中的数据, 也可以将数据存储到平面文件中。

例如,DTWF_APPEND 将一个表格变量的内容写入文件末尾,而 DTWF_DELETE 从文件中删除记录。

另外,FFI 函数允许使用 DTWF_CLOSE 和 DTWF_OPEN 来进行文件锁定。DTWF_OPEN 锁定一个文件, 这样其他请求就无法读取或更新该文件。DTWF_CLOSE 在 Net.Data 完成处理之后释放文件, 从而允许其他请求访问该文件。


Web 注册表函数

使用 Web 注册表函数来维护注册表及其包含的条目。Web 注册表是一个文件,由 Net.Data 维护 此文件的一个关键字,允许您方便地添加、检索和删除其中的条目。

例如,DTWR_ADDENTRY 添加条目,而 DTWR_DELENTRY 删除条目。DTWR_LISTSUB 在一个 OUT 表格参数中返回有关注册表条目的信息,而 DTWR_UPDATEENTRY 用一个新值 替换指定注册表条目的现有值。


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]