Net.Data 参考指南

Net.Data 内部函数

Net.Data 提供了许多可以不在 FUNCTION 模块中使用的函数。这些函数名称是不区别大小写的。Net.Data 内部函数分成以下这些类别：

一般函数可以帮助您使用 Net.Data 来开发 Web 页，这些函数不包括在其它类别中。请参阅"一般函数"。
数学函数用于执行数学运算。请参阅"数学函数"。
字符串处理函数用于修改字符串和字符。请参阅"字符串函数"。
字处理函数用于处理字。请参阅"字处理函数"。
表格处理函数可以帮助您定制表格。请参阅"表格函数"。
平面文件接口函数用于执行文件的输入和输出。请参阅"平面文件接口"。
Web 注册表函数执行 Web 注册表上的操作。请参阅 "Web 注册表函数"。

许多函数具有一个或多个的下列格式：

以 DTW_、DTWF_ 和 DTWR_ 开头的函数将结果返回在一个输出参数中。因此必须指定输出参数。此例子显示了服务器的时间：
```
@DTW_TIME(nowTime)
当前的本地时间是 $(nowTime)。
```
以 DTW_r、DTWF_r 和 DTWR_r 开头的函数将结果返回到函数调用，因此不需要指定输出参数。此例子显示了服务器的时间，与前一例子相同：
```
当前的本地时间是 @DTW_rTIME()。
```
以 DTW_m 开头的函数需要带多个参数。每个参数都同时作为输入参数和输出参数使用。其结果返回在相应的输入参数中。此例子将 3 个输入参数都转换为大写，以便在输出显示上保持一致：
```
@DTW_mUPPERCASE(model, style, shipNo)
Shipment $(shipNo) contains $(quantity) of model $(model) $(style).
```

函数参数必须以正确的顺序放置。最后一个输入参数之前的所有输入参数都必须指定，或指定为一个空串("")，表示接收缺省值。例如，可以用以下方法调用 DTW_TB_INPUT_TEXT：

@DTW_TB_INPUT_TEXT(myTable, "1", "2", "", "", "32")

其中，第四和第五个参数将使用缺省值。它们必须被指定为空值，以便在生成的 HTML 中 MAXLENGTH 的值为 "32"。最后一个参数未指定，因此使用缺省值。如果 MAXLENGTH 和前面的两个参数都接受缺省值，则可以将其省略：

@DTW_TB_INPUT_TEXT(myTable, "1", "2")

当后续参数中有非空的输入参数时，必须指定输入参数列表中中间参数的空值。在指定最后的输出参数之前，不必要指定中间的空输入参数。

在后面的描述中，函数参数的类型为字符串、整数、浮点数 和数组 (数组表示了一张表格)。所有的 Net.Data 变量都是字符串类型的，但仍使用术语“整数”、 “浮点数”或“数组”来分别指示表示整数、浮点数或数组值的一个字符串。

一般函数

这些是一般目的的函数，可以用于：

DTW_ADDQUOTE
DTW_DATE
DTW_GETENV
DTW_GETINIDATA
DTW_HTMLENCODE
DTW_QHTMLENCODE
DTW_SETENV
DTW_TIME
DTW_URLESCSEQ

DTW_ADDQUOTE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将一个输入字符串中的单引号替换成双引号。如果某个字符串包含单引号，则需要转换为双引号，SQL 语句才能顺利完成。

语法

@DTW_ADDQUOTE(stringIn, stringOut)
@DTW_rADDQUOTE(stringIn)
@DTW_mADDQUOTE(stringMult, stringMult2, ..., stringMultn)

参数

表 1. DTW_ADDQUOTE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。DTW_mADDQUOTE 可以有多个输入字符串。
字符串 stringOut OUT 包含有 stringIn 修改后结果的一个变量。
字符串 stringMult INOUT

输入：一个包含字符串的变量。
输出：一个包含输入字符串的变量，其中每个单引号(')字符都被替换成两个单引号。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。DTW_mADDQUOTE 可以有多个输入字符串。
字符串	`stringOut`	OUT	包含有 stringIn 修改后结果的一个变量。
字符串	`stringMult`	INOUT	输入：一个包含字符串的变量。输出：一个包含输入字符串的变量，其中每个单引号(')字符都被替换成两个单引号。

例子

例子 1：

@DTW_ADDQUOTE(string1,string2)

输入：string1 = "John's Web page"
返回：string2 = "John''s Web page"

例子 2：

@DTW_rADDQUOTE("The article's title is 'Once upon a time'")

返回：The article''s title is ''Once upon a time''

例子 3：

@DTW_mADDQUOTE(string1,string2)

输入：string1="Joe's bag", string2="'to be or not to be'"
输出：string1="Joe''s bag", string2="''to be or not to be''"

DTW_DATE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

以指定的格式返回当前的系统日期。

语法

@DTW_DATE(format, stringOut)
@DTW_DATE(stringOut)
@DTW_rDATE(format)
@DTW_rDate()

参数

表 2. DTW_DATE 参数

数据类型参数用法说明
字符串 format IN 一个用于指定数据格式的变量或文字串。有效的格式包括：

D--一年中的天 (001-366)
E--欧洲日期格式 (dd/mm/yy)
N--正常日期格式 (dd mon yyyy)
O--顺序日期格式 (yy/mm/dd)
S--标准日期格式 (yyyymmdd)
U--美国日期格式 (mm/dd/yy)

缺省值为 N。
字符串 stringOut OUT 一个包含有指定格式的日期的变量。

数据类型	参数	用法	说明
字符串	`format`	IN	一个用于指定数据格式的变量或文字串。有效的格式包括： D--一年中的天 (001-366) E--欧洲日期格式 (dd/mm/yy) N--正常日期格式 (dd mon yyyy) O--顺序日期格式 (yy/mm/dd) S--标准日期格式 (yyyymmdd) U--美国日期格式 (mm/dd/yy) 缺省值为 N。
字符串	`stringOut`	OUT	一个包含有指定格式的日期的变量。

例子

例子 1：

@DTW_DATE(results)

返回：results = "25 Apr 1997"

例子 2：

@DTW_DATE("E", results)

返回：results="25/04/97"

例子 3：

%HTML(report){
<P>This report created on @DTW_rDATE("U").

返回：04/25/97

DTW_GETENV

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回指定的环境变量的值。同样可以使用 ENVVAR 来获取环境变量的值。有关的更多信息，请参阅ENVVAR 语句。

语法

@DTW_GETENV(envVarName, envVarValue)
@DTW_rGETENV(envVarName)

参数

表 3. DTW_GETENV 参数

数据类型参数用法说明
字符串 envVarName IN 一个变量或文字串。
字符串 envVarValue OUT 在 envVarName 中指定的环境变量的值。如果找不到这个值则返回空串。

数据类型	参数	用法	说明
字符串	`envVarName`	IN	一个变量或文字串。
字符串	`envVarValue`	OUT	在 envVarName 中指定的环境变量的值。如果找不到这个值则返回空串。

例子

例子 1：

@DTW_GETENV(myEnvVarName, myEnvVarValue)

输入：myEnvVarName = "PATH"
返回：myEnvVarValue = "/usr/path"

例子 2：

@DTW_rGETENV(myPath)

输入：myPath = "PATH"
返回："/usr/path"

例子 3：

The server is @DTW_rGETENV("SERVER_NAME").

返回："www.software.ibm.com"

DTW_GETINIDATA

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回指定的配置变量的值。如果找不到这个值则返回空串。
注意: 不能用这个调用返回特殊的配置路径变量 MACRO_PATH、 EXEC_PATH、INCLUDE_PATH 以及 ENVIRONMENT 语句。

语法

@DTW_GETINIDATA(iniVarName, iniVarValue)
@DTW_rGETINIDATA(iniVarName)

参数

表 4. DTW_GETINIDATA 参数

数据类型参数用法说明
字符串 iniVarName IN 一个变量或文字串。
字符串 iniVarValue OUT 在 iniVarName 中指定的配置变量的值。

数据类型	参数	用法	说明
字符串	`iniVarName`	IN	一个变量或文字串。
字符串	`iniVarValue`	OUT	在 iniVarName 中指定的配置变量的值。

例子

例子 1：

@DTW_GETINIDATA(myEnvVarName, myEnvVarValue)

输入：myEnvVarName = "FFI_PATH"
返回：myEnvVarValue = "D:\FFI"

例子 2：

@DTW_rGETINIDATA("HTTP_COOKIE")

返回："cookie.txt"

DTW_HTMLENCODE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

大多数(但非所有)字符的编码字符(使用标准 HTML 十进制转义代码。)您可以使用此函数对不想让浏览器解释为 HTML 的数据进行编码。例如，通过使用适当的转义字符，可以显示小于(<)和大于(>)符号，这些符号通常作为 HTML 标记保留。

对于第二个例子，在 HTML 字符串

"1    2     3"

中，每个数字间只显示一个空格。使用 DTW_HTMLENCODE 来确保显示正确个数的空格。

以下字符将由 DTW_HTMLENCODE 函数进行编码：

表 5. HTML 十进制转义字符

字符名称代码
SPACE 空格  
" 双引号 "
# 数值符号 #
% 百分号 %
& &符号 &
/ 反斜杠 \
: 冒号 :
; 分号 ;
< 小于 <
= 等于 &#61:
> 大于 &#62:
? 问号 &#63:
@ @符号 @
[ 左方括号 (
\ 斜杠 /
] 右方括号 )
^ ^符号 ^
{ 左花括号 {
| 竖线 |
} 右花括号 }
~ ~符号 ~

语法

@DTW_HTMLENCODE(stringIn, stringOut)
@DTW_rHTMLENCODE(stringIn)

参数

表 6. DTW_HTMLENCODE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 stringOut OUT 一个包含已修改后的输入字符串的变量，其中输入字符串中的某些字符已经被 HTML 转义字符编码所替换。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。
字符串	`stringOut`	OUT	一个包含已修改后的输入字符串的变量，其中输入字符串中的某些字符已经被 HTML 转义字符编码所替换。

例子

例子 1：

@DTW_HTMLENCODE(string1,string2)

输入：string1 = "Jim's dog"
返回：string2 = "Jim's dog"

例子 2：

@DTW_rHTMLENCODE("X <= 10")

返回："X <= 10"

DTW_QHTMLENCODE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

与 @DTW_HTMLENCODE 执行相同的功能，但另外还把单引号(')编码为 。 DTW_QHTMLENCODE 所使用的 HTML 十进制转义字符显示在表 5中。

考虑对所有 SQL INPUT 语句使用此函数。例如，如果输入 O'Brien 作为姓名，则如下例所示，其中的单引号会导致一个错误：

INSERT INTO USER1.CUSTABLE (LNAME, FNAME)
VALUES ('O'Brien', 'Patrick')

在使用 DTW_QHTMLENCODE 函数更改 SQL 语句后，就避免了错误：

INSERT INTO USER1.CUSTABLE (LNAME, FNAME)
VALUES ('O&#39;Brien', 'Patrick')

详细细节见例子 3。

语法

@DTW_QHTMLENCODE(stringIn, stringOut)
@DTW_rQHTMLENCODE(stringIn)

参数

表 7. DTW_QHTMLENCODE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 stringOut OUT 一个包含已修改后的表 stringIn 的变量，其中的某些字符已经被 HTML 转义字符编码所替换。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。
字符串	`stringOut`	OUT	一个包含已修改后的表 stringIn 的变量，其中的某些字符已经被 HTML 转义字符编码所替换。

例子

例子 1：

@DTW_QHTMLENCODE(string1,string2)

输入：string1 = "Jim's dog"
返回：string2 = "Jim's dog"

例子 2：

@DTW_rQHTMLENCODE("John's & Jane's")

返回："John's & Jane's"

例子 3：

%FUNCTION(DTW_SQL) insertName(){
INSERT INTO USER2A.SURVEY
(NAME) VALUES '@DTW_rQHTMLENCODE(fullname)'
%}

输入：fullname = "Patrick O'Brien"
返回：'Patrick O'Brien'

DTW_SETENV

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

用指定的值设置环境变量并返回先前的值。如果找不到这个值则返回空串。

语法

@DTW_SETENV(envVarName, envVarValue, prevValue)
@DTW_rSETENV(envVarName, envVarValue)

参数

表 8. DTW_SETENV 参数

数据类型参数用法说明
字符串 envVarName IN 一个表示环境变量的变量或文字串。
字符串 envVarValue OUT 一个包含有要设置的环境变量值的变量或文字串。
字符串 prevValue OUT 一个包含有环境变量先前值的变量。DTW_rSETENV 返回这个值作为函数的返回值。

数据类型	参数	用法	说明
字符串	`envVarName`	IN	一个表示环境变量的变量或文字串。
字符串	`envVarValue`	OUT	一个包含有要设置的环境变量值的变量或文字串。
字符串	`prevValue`	OUT	一个包含有环境变量先前值的变量。DTW_rSETENV 返回这个值作为函数的返回值。

例子

例子 1：

@DTW_SETENV("PATH", "myPath", prevValue)

输入：myPath = "myPath"
返回：prevValue = "myPreviousPath"

例子 2：

@DTW_rSETENV("PATH", "myPath")

输入：myPath = "myPath"
返回："myPreviousPath", PATH = "myPath"

DTW_TIME

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

以指定的格式返回当前的系统时间。

语法

@DTW_TIME(stringIn, stringOut)
@DTW_TIME(stringOut)
@DTW_rTIME(stringIn)
@DTW_rTIME()

参数

表 9. DTW_TIME 参数

数据类型参数用法说明
字符串 stringIn IN 一个用于指定时间格式的变量或文字串。有效的格式是：

C 民用时间 (hh:mmAM/PM，使用 12 小时时钟)
L 本地时间 (hh:mm:ss)
N 正常时间 (hh:mm:ss，使用 24 小时时钟)
H 从子夜以来的小时数
M 从子夜以来的分钟数
S 从子夜以来的秒数

字符串 stringOut OUT 一个包含有指定格式的时间的变量。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个用于指定时间格式的变量或文字串。有效的格式是： C 民用时间 (hh:mmAM/PM，使用 12 小时时钟) L 本地时间 (hh:mm:ss) N 正常时间 (hh:mm:ss，使用 24 小时时钟) H 从子夜以来的小时数 M 从子夜以来的分钟数 S 从子夜以来的秒数
字符串	`stringOut`	OUT	一个包含有指定格式的时间的变量。

例子

例子 1：

@DTW_TIME(results)

返回：results = "10:30:53"

例子 2：

@DTW_TIME("C", results)

返回：results = "10:30AM"

例子 3：

@DTW_rTIME("M")

返回："630"

例子 4:

%REPORT{
<P>This report was created at @DTW_rTIME(), @DTW_rDATE().
%}

返回：This report was created 15:04:39, 01 May 1997.

DTW_URLESCSEQ

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将不允许在 URL 中出现的字符替换为对应的转义字符。必须使用此函数把在表 10中列出的字符传递给另一个宏文件或 HTML 摸块。

表 10. 在 URL 中不允许出现的字符

字符名称代码
SPACE 空格 &#20
" 双引号 &#22
# 数值符号 &#23
% 百分号 &#25
& &符号 &#26
/ 反斜杠 &#2F
: 冒号 &#3A
; 分号 &#3B
< 小于 &#3C
= 等于 &#3D
> 大于 &#3E
? 问号 &#3F
@ @符号 &#40
[ 左方括号 &#5B
\ 斜杠 &#5C
] 右方括号 &#5D
^ ^符号 &#5E
{ 左花括号 &#7B
| 竖线 &#7C
} 右花括号 &#7D
~ ~符号 &#7E

语法

@DTW_URLESCSEQ(stringIn, stringOut)
@DTW_rURLESCSEQ(stringIn)

参数

表 11. DTW_URLESCSEQ 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 stringOut OUT 一个包含输入字符串的变量，其中输入字符串中不允许在 URL 中出现的字符已经被替换成其十六进制的转义值。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。
字符串	`stringOut`	OUT	一个包含输入字符串的变量，其中输入字符串中不允许在 URL 中出现的字符已经被替换成其十六进制的转义值。

例子

例子 1：

@DTW_URLESCSEQ(string1,string2)

输入：string1 = "Guys & Dolls"
返回：string2 = "Guys%20%26%20Dolls"

例子 2：

@DTW_rURLESCSEQ("Guys & Dolls")

返回："Guys%20%26%20Dolls"

例子 3: 本例子在 ROW 模块中使用了 DTW_rURLESCSEQ。当应用程序用户单击名称时，名称和 e-mail 地址都被发送到 Net.Data 宏 fullrpt.mac 的输入模块中，并把编码后的值作为变量 name 和 email。

%ROW{
<P><a href="fullRpt.mac/input?name=@DTW_rURLESCSEQ(V1)&email=@DTW_rULRESCSEQ(V2)">
$(V1)</a>
%}

输入：V1="Patrick O'Brien", V2="obrien@ibm.com"

<P><a href="fullrpt.mac/input?name=Patrick%20O'Brien&email="obrien%40ibm.com">
Patrick O'Brien</a>

数学函数

这些函数可以让您完成大部分类型的数学运算。

DTW_ADD
DTW_DIVIDE
DTW_DIVREM
DTW_FORMAT
DTW_INTDIV
DTW_MULTIPLY
DTW_POWER
DTW_SUBTRACT

DTW_ADD

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将两个参数的值相加。

语法

@DTW_ADD(number1, number2, precision, result)
@DTW_rADD(number1, number2, precision)

参数

表 12. DTW_ADD 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 和 number2 之和的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 和 number2 之和的变量。

例子

例子 1：

@DTW_ADD(NUMB1, NUMB2, "2", result)

输入：NUMB1 = "105", NUMB2 = "3"
返回：result = "1.1E+2"

例子 2：

@DTW_rADD("12",NUMB2,"5")

输入：NUMB2 = "7.00"
返回："19.00"

DTW_DIVIDE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

第一个参数的值除以第二个参数的值。

语法

@DTW_DIVIDE(number1, number2, precision, result)
@DTW_rDIVIDE(number1, number2, precision)

参数

表 13. DTW_DIVIDE 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 除以 number2 的结果的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 除以 number2 的结果的变量。

例子

例子 1：

@DTW_DIVIDE("8.0", NUMB2, result)

输入：NUMB2 = "2"
返回：result = "4"

例子 2：

@DTW_rDIVIDE("1",NUMB2,"5")

输入："1", NUMB2 = "3"
返回："0.33333"

例子 3：

@DTW_rDIVIDE(NUMB1,"2","5")

输入：NUMB1 = "5"
返回："2.5"

DTW_DIVREM

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

第一个参数除以第二个参数，并返回余数。如果余数非零，则余数的符号与第一个参数相同。如果结果不能表示为一个整数，则操作有错误并失败。

语法

@DTW_DIVREM(number1, number2, precision, result)
@DTW_rDIVREM(number1, number2, precision)

参数

表 14. DTW_DIVREM 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 除以 number2 的余数的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 除以 number2 的余数的变量。

例子

例子 1：

@DTW_DIVREM(NUMB1, NUMB2, result)

输入：NUMB1 = "2.1", NUMB2 = "3"
返回：result = "2.1"

例子 2：

@DTW_rDIVREM("10",NUMB2)

输入：NUMB2 = "0.3"
返回："0.1"

例子 3：

@DTW_rDIVREM("3.6","1.3")

返回："1.0"

例子 4:

@DTW_rDIVREM("-10","3")

返回："-1"

DTW_FORMAT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

定制一个数的格式。如果只指定 number 参数，则其格式化结果与执行 @DTW_rADD(number,"0") 语句相同。如果指定了其它某个选项，那么将按照以下规则来格式化 number：

before 和 after 选项描述了分别有多少个字符用于结果的整数和小数部分。如果省略了这些选项，则用于那些部分的字符个数就与结果中需要的长度相同。
如果 before 的值不够大，无法包含此数的整数部分(加上正数的符号)，则产生一个错误的结果。如果 before 的值大于那部分的所需大小，则在数的左边用空格填充。如果 after 的大小与数的小数部分不同，则此数将被舍入(或以 0 来扩充)，使其结果为 after 的指定大小。如果指定 0，这将引起此数被舍入成为一个整数。
另外，expp 和 expt 控制了结果的指数部分。expp 设置了指数部分的位数，缺省情况下，将使用所需的位数(可能为 0)。expt 设置了使用指数表示法的触发点。其缺省值是精度参数的缺省值。
如果 expp 是 0，则不提供指数表示，而以简单形式来表示此数，需要时添加 0。如果 expp 不是足够大，不能包含指数，则产生一个错误。
如果整数或小数部分所需的位数分别超过 expt 或 expt 的两倍，则使用指数部分。如果 expt 是 0，则总是使用指数表示法，除非指数为 0。( 如果 expp 为 0，这将覆盖 expt 值为 0 的情况。) 如果 expp 为非零时指数为 0，那么将在结果的指数部分提供 expp+2 个空格。如果指数是 0，并且没有指定 expp，则将使用简单表示形式。

语法

@DTW_FORMAT(number, before, after, expp, expt, precision, result)
@DTW_rFORMAT(number, before, after, expp, expt, precision)

参数

表 15. DTW_FORMAT 参数

数据类型参数用法说明
浮点数 number IN 一个表示数值的变量或文字串。
整数 before IN 一个表示正整数的变量或文字串。这是一个可选参数。必须输入一个空串("")，以使用其它参数。
整数 after IN 一个表示正整数的变量或文字串。这是一个可选参数。必须输入一个空串("")，以使用其它参数。
整数 expp IN 一个表示正整数的变量或文字串。必须输入一个空串("")，以使用其它参数。
整数 expt IN 一个表示正整数的变量或文字串。必须输入一个空串("")，以使用其它参数。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含指定舍入和格式状态的数的变量。

数据类型	参数	用法	说明
浮点数	`number`	IN	一个表示数值的变量或文字串。
整数	`before`	IN	一个表示正整数的变量或文字串。这是一个可选参数。必须输入一个空串("")，以使用其它参数。
整数	`after`	IN	一个表示正整数的变量或文字串。这是一个可选参数。必须输入一个空串("")，以使用其它参数。
整数	`expp`	IN	一个表示正整数的变量或文字串。必须输入一个空串("")，以使用其它参数。
整数	`expt`	IN	一个表示正整数的变量或文字串。必须输入一个空串("")，以使用其它参数。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含指定舍入和格式状态的数的变量。

例子

例子 1：

@DTW_FORMAT(NUMB, BEFORE, result)

输入：NUMB = "3", BEFORE = "4"
返回：result= " 3"

例子 2：

@DTW_FORMAT("1.73", "4", "0", result)

返回：result = " 2"

例子 3：

@DTW_FORMAT("1.73", "4", "3", result)

返回：result = " 1.730"

例子 4:

@DTW_FORMAT(" - 12.73", "", "4", result)

返回：result = "-12.7300"

例子 5：

@DTW_FORMAT("12345.73", "", "", "2", "2", result)

返回：result = "1.234573E+04"

例子 6：

@DTW_FORMAT("1.234573", "", "3", "", "0", result)

返回：result = "1.235"

例子 7：

@DTW_rFORMAT(" - 12.73")

返回：" - 12.73"

例子 8：

@DTW_rFORMAT("0.000")

返回："0"

例子 9：

@DTW_rFORMAT("12345.73","","","3","6")

返回："12345.73"

例子 10：

@DTW_rFORMAT("1234567e5","","3","0")

返回："123456700000.000"

例子 11：

@DTW_rFORMAT("12345.73","","3","","0")

返回："1.235E+4"

DTW_INTDIV

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

第一个参数除以第二个参数，并返回结果的整数部分。

语法

@DTW_INTDIV(number1, number2, precision, result)
@DTW_rINTDIV(number1, number2, precision)

参数

表 16. DTW_INTDIV 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 除以 number2 的整数部分的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 除以 number2 的整数部分的变量。

例子

例子 1：

@DTW_INTDIV(NUMB1, NUMB2, result)

输入：NUMB1 = "10", NUMB2 = "3"
返回：result = "3"

例子 2：

@DTW_rINTDIV("2",NUMB2)

输入：NUMB2 = "3"
返回："0"

DTW_MULTIPLY

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

两个参数相乘。

语法

@DTW_MULTIPLY(number1, number2, precision, result)
@DTW_rMULTIPLY(number1, number2, precision)

参数

表 17. DTW_MULTIPLY 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 和 number2 乘积的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 和 number2 乘积的变量。

例子

例子 1：

@DTW_MULTIPLY(NUM1, NUMB2, result)

输入：NUMB1 = "4", NUMB2 = "5"
返回：result = "20"

例子 2：

@DTW_rMULTIPLY("0.9",NUMB2)

输入：NUMB2 = "0.8"
返回："0.72"

DTW_POWER

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

第一个参数的第二个参数次方。

语法

@DTW_POWER(number1, number2, precision, result)
@DTW_rPOWER(number1, number2, precision)

参数

表 18. DTW_POWER 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 的 number2 次方的结果的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 的 number2 次方的结果的变量。

例子

例子 1：

@DTW_POWER(NUMB1, NUMB2, result)

输入：NUMB1 = "2", NUMB2 = "-3"
返回：result = "0.125"

例子 2：

@DTW_rPOWER("1.7", NUMB2, precision)

输入：NUMB2 = "8", precision = "5"
返回："69.758"

DTW_SUBTRACT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

第一个参数的值减去第二个参数的值。

语法

@DTW_SUBTRACT(number1, number2, precision, result)
@DTW_rSUBTRACT(number1, number2, precision)

参数

表 19. DTW_SUBTRACT 参数

数据类型参数用法说明
浮点数 number1 IN 一个表示数值的变量或文字串。
浮点数 number2 IN 一个表示数值的变量或文字串。
整数 precision IN 一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数 result OUT 一个包含 number1 和 number2 之差的变量。

数据类型	参数	用法	说明
浮点数	`number1`	IN	一个表示数值的变量或文字串。
浮点数	`number2`	IN	一个表示数值的变量或文字串。
整数	`precision`	IN	一个表示正整数的变量或文字串，此整数指定了结果的精确度。缺省值是 9。
浮点数	`result`	OUT	一个包含 number1 和 number2 之差的变量。

例子

例子 1：此例子说明了一种比较两个数值(Net.Data 中的字符串)大小的方法。

@DTW_SUBTRACT(NUM1, NUMB2, comp)
%IF(comp > "0")
<P>$(NUM1) is larger than  $(NUM2).
%ENDIF

输入：NUMB2 = "2.07"
返回："-0.77"

例子 2：

@DTW_SUBTRACT(NUMB1, NUMB2, result)

输入：NUMB1 = "1.3, NUMB2 = "1.07"
返回：result = "0.23"

例子 3：

@DTW_rSUBTRACT("1.3",NUMB2)

输入：NUMB2 = "2.07"
返回："-0.77"

字符串函数

以下是由 Net.Data 支持的标准字符串函数的集合：

DTW_ASSIGN
DTW_CONCAT
DTW_DELSTR
DTW_INSERT
DTW_LASTPOS
DTW_LENGTH
DTW_LOWERCASE
DTW_POS
DTW_REVERSE
DTW_STRIP
DTW_SUBSTR
DTW_TRANSLATE
DTW_UPPERCASE

注意: 除了 OS/400 以外，Net.Data 不支持任何平台上的多字节字符串处理。

DTW_ASSIGN

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将一个输入变量的值赋给输出变量。因为在 REPORT 模块之外不能识别 $(Vn) (其中 n 是一个数)，所以如果要在 ROW 模块之外引用这个值，可以使用这个函数将值赋给另一个变量。

同样可以使用这个函数在宏中更改一个变量。例如，您可以更改 HTML 块中的 DATABASE。(请参阅DATABASE中的例子。)

语法

@DTW_ASSIGN(stringOut, stringIn)

参数

表 20. DTW_ASSIGN 参数

数据类型参数用法说明
字符串 stringOut OUT 一个变量，其中包含的文字串与 stringIn 值相同。
字符串 stringIn IN 一个变量或文字串。

数据类型	参数	用法	说明
字符串	`stringOut`	OUT	一个变量，其中包含的文字串与 stringIn 值相同。
字符串	`stringIn`	IN	一个变量或文字串。

例子

例子 1：

@DTW_ASSIGN(RC, "0")

将 RC 设置为 "0"。

例子 2：

@DTW_ASSIGN(string1, string2)

将 string2 的值赋给 string1.

DTW_CONCAT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

连接两个字符串。

语法

@DTW_CONCAT(stringIn1, stringIn2, stringOut)
@DTW_rCONCAT(stringIn1, stringIn2)

参数

表 21. DTW_CONCAT 参数

数据类型参数用法说明
字符串 stringIn1 IN 一个变量或文字串。
字符串 stringIn2 IN 一个变量或文字串。
字符串 stringOut OUT 一个包含 'stringIn1 + stringIn2' 字符串的变量。

数据类型	参数	用法	说明
字符串	`stringIn1`	IN	一个变量或文字串。
字符串	`stringIn2`	IN	一个变量或文字串。
字符串	`stringOut`	OUT	一个包含 'stringIn1 + stringIn2' 字符串的变量。

例子

例子 1：

@DTW_CONCAT("This", " is a test.", result)

返回：result = "This is a test."

例子 2：

@DTW_CONCAT(string1, "Jose!", result)

输入：string1 = "No way "
返回：result = "No way Jose!"

例子 3：

@DTW_rCONCAT("This", " is a test.")

返回："This is a test."

DTW_DELSTR

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从指定的字符串删除从第 n 个字符开始，长度为 length 的一个子串。

语法

@DTW_DELSTR(stringIn, n, length, stringOut)
@DTW_DELSTR(stringIn, n, stringOut)
@DTW_rDELSTR(stringIn, n, length)
@DTW_rDELSTR(stringIn, n)

参数

表 22. DTW_DELSTR 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 要删除的子串所开始的字符位置。如果 n 的值大于 stringIn 的长度，则将 stringOut 设置成 stringIn 的值。
整数 length OUT 要删除的子串的长度。缺省情况是删除到字符串 stringIn 结尾为止的所有字符。
字符串 stringOut OUT 包含有 stringIn 修改后的结果的一个变量。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。
整数	`n`	IN	要删除的子串所开始的字符位置。如果 n 的值大于 stringIn 的长度，则将 stringOut 设置成 stringIn 的值。
整数	`length`	OUT	要删除的子串的长度。缺省情况是删除到字符串 stringIn 结尾为止的所有字符。
字符串	`stringOut`	OUT	包含有 stringIn 修改后的结果的一个变量。

例子

例子 1：

@DTW_DELSTR("abcde", "3", "2", result)

返回：result = "abe"

例子 2：

@DTW_rDELSTR("abcde","6","1")

返回："abcde"

DTW_INSERT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将一个字符串插入到另一个字符串的第 n 个字符后。

语法

@DTW_INSERT(stringIn1, stringIn2, n, length, pad, stringOut)
@DTW_INSERT(stringIn1, stringIn2, n, length, stringOut)
@DTW_INSERT(stringIn1, stringIn2, n, stringOut)
@DTW_INSERT(stringIn1, stringIn2, stringOut)
@DTW_rINSERT(stringIn1, stringIn2, n, length, pad)
@DTW_rINSERT(stringIn1, stringIn2, n, length)
@DTW_rINSERT(stringIn1, stringIn2, n)
@DTW_rINSERT(stringIn1, stringIn2)

参数

表 23. DTW_INSERT 参数

数据类型参数用法说明
字符串 stringIn1 IN 一个要插入到 stringIn2 中去的变量或文字串。
字符串 stringIn2 IN 一个变量或文字串。
整数 n IN stringIn2 中的字符位置，在这个位置后面插入 stringIn1。如果 n 大于 stringIn2 的长度，则在其中填满填充字符，直至有足够个数的字符为止。缺省情况是在 stringIn2 的开头插入。
整数 length IN stringIn1 中要用于插入的字符个数。如果此参数的值大于 stringIn1 的长度，则用填充字符 pad 来填充。缺省情况是 stringIn1 的长度。
整数 pad IN 用于描述 n 和 length 的填充字符。缺省填充字符是一个空格。
字符串 stringOut OUT 一个包含 stringIn2 的变量，已插入全部或部分 stringIn1。

数据类型	参数	用法	说明
字符串	`stringIn1`	IN	一个要插入到 stringIn2 中去的变量或文字串。
字符串	`stringIn2`	IN	一个变量或文字串。
整数	`n`	IN	stringIn2 中的字符位置，在这个位置后面插入 stringIn1。如果 n 大于 stringIn2 的长度，则在其中填满填充字符，直至有足够个数的字符为止。缺省情况是在 stringIn2 的开头插入。
整数	`length`	IN	stringIn1 中要用于插入的字符个数。如果此参数的值大于 stringIn1 的长度，则用填充字符 pad 来填充。缺省情况是 stringIn1 的长度。
整数	`pad`	IN	用于描述 n 和 length 的填充字符。缺省填充字符是一个空格。
字符串	`stringOut`	OUT	一个包含 stringIn2 的变量，已插入全部或部分 stringIn1。

例子

例子 1：

@DTW_INSERT("123", "abc", result)

返回：result = "123abc"

例子 2：

@DTW_INSERT("123", "abc", "5", result)

返回：result = "abc 123"

例子 3：

@DTW_INSERT("123", "abc", "5", "6", result)

返回：result = "abc 123 "

例子 4:

@DTW_INSERT("123", "abc", "5", "6", "_", result)

返回：result = "abc__123___"

例子 5：

@DTW_rINSERT("123","abc","5","6","+")

返回："abc++123+++"

DTW_LASTPOS

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个字符串在另一个字符串中最后一次出现的位置，从第 n 个字符开始往字符串开始方向查找。

语法

@DTW_LASTPOS(stringIn1, stringIn2, n, position)
@DTW_LASTPOS(stringIn1, stringIn2, position)
@DTW_rLASTPOS(stringIn1, stringIn2, n)
@DTW_rLASTPOS(stringIn1, stringIn2)

参数

表 24. DTW_LASTPOS 参数

数据类型参数用法说明
字符串 stringIn1 IN 一个要在 stringIn2 中搜索的变量或文字串。
字符串 stringIn2 IN 一个变量或文字串。
整数 n IN 在 stringIn2 中搜索 stringIn1 的开始字符位置。缺省情况是从第一个字符开始搜索。
整数 position OUT stringIn2 中最后一次出现 stringIn1 的位置。如果找不到这种串，就返回 0。

数据类型	参数	用法	说明
字符串	`stringIn1`	IN	一个要在 stringIn2 中搜索的变量或文字串。
字符串	`stringIn2`	IN	一个变量或文字串。
整数	`n`	IN	在 stringIn2 中搜索 stringIn1 的开始字符位置。缺省情况是从第一个字符开始搜索。
整数	`position`	OUT	stringIn2 中最后一次出现 stringIn1 的位置。如果找不到这种串，就返回 0。

例子

例子 1：

@DTW_LASTPOS(" ", "abc def ghi", result)

返回：result = "8"

例子 2：

@DTW_LASTPOS(" ", "abc def ghi", "10", result)

返回：result = "8"

例子 3：

@DTW_rLASTPOS(" ","abc def ghi","7")

返回："4"

DTW_LENGTH

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回字符串的长度。

语法

@DTW_LENGTH(stringIn, length)
@DTW_rLENGTH(stringIn)

参数

表 25. DTW_LENGTH 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 length OUT 一个包含 stringIn 长度的符号。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串。
整数	`length`	OUT	一个包含 stringIn 长度的符号。

例子

例子 1：

@DTW_LENGTH("abcdefgh", result)

返回：result = "8"

例子 2：

@DTW_rLENGTH("")

返回："0"

DTW_LOWERCASE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个所有字符全为小写的字符串。

语法

@DTW_LOWERCASE(stringIn, stringOut)
@DTW_rLOWERCASE(stringIn)
@DTW_mLOWERCASE(stringMult1, stringMult2, ..., stringMultn)

参数

表 26. DTW_LOWERCASE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串，其中的字符可以是大写或小写。
字符串 stringOut OUT 一个包含 stringIn 的变量，其中所有的字符都为小写。
字符串 stringMult INOUT

输入：一个包含字符串的变量。
输出：一个包含输入字符串的变量，其中的所有字符都已转换为大写。

例子

例子 1：

@DTW_LOWERCASE("This", stringOut)

返回：stringOut = "this"

例子 2：

@DTW_rLOWERCASE(string1)

输入：string1 = "Web Pages"
返回："web pages"

例子 3：

@DTW_mLOWERCASE(string1, string2, string3)

输入：string1 = "THIS", string2 = "IS", string3 = "LOWERCASE"
返回：string1 = "this", string2 = "is", string3 = "lowercase"

DTW_POS

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个字符串在另一个字符串中第一次出现的位置。

语法

@DTW_POS(stringIn1, stringIn2, n, nOut)
@DTW_POS(stringIn1, stringIn2, nOut)
@DTW_rPOS(stringIn1, stringIn2, n)
@DTW_rPOS(stringIn1, stringIn2)

参数

表 27. DTW_POS 参数

数据类型参数用法说明
字符串 stringIn1 IN 一个要搜索的变量或文字串。
字符串 stringIn2 IN 一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数 n IN stringIn2 中要开始搜索的字符位置。缺省值是从 stringIn2 的第一个字符开始搜索。
整数 nOut OUT 包含 stringIn1 在 stringIn2 中第一次出现的位置值的一个变量。如果找不到这种串，就返回 0。

例子

例子 1：

@DTW_POS("day", "Saturday", result)

返回：result = "6"

例子 2：

@DTW_POS("a", "Saturday", "3", result)

返回：result = "7"

例子 3：

@DTW_rPOS(" ","abc def ghi","5")

返回："8"

DTW_REVERSE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

将输入字符串倒置过来。

语法

@DTW_REVERSE(stringIn, stringOut)
@DTW_rREVERSE(stringIn)

参数

表 28. DTW_REVERSE 参数

数据类型参数用法说明
字符串 stringIn IN 一个要倒置的变量或文字串。
字符串 stringOut OUT 一个包含倒置后的 stringIn 的变量。

例子

例子 1：

@DTW_REVERSE("This is it.", result)

返回：result = ".ti si sihT"

例子 2：

@DTW_rREVERSE(string1)

输入：string1 = "reversed"
返回："desrever"

DTW_STRIP

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从输入字符串删除前导空格或尾随空格(或同时删除)。

语法

@DTW_STRIP(stringIn, option, stringOut)
@DTW_STRIP(stringIn, stringOut)
@DTW_rSTRIP(stringIn, option)
@DTW_rSTRIP(stringIn)

参数

表 29. DTW_STRIP 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 option IN 指定要从 stringIn 删除哪些空格。缺省值是 B。

B 或 b：同时删除前导和尾随空格
L 或 l：删除前导空格
T 或 t：删除尾随空格

字符串 stringOut OUT 一个包含 stringIn 的变量，其中已经根据指定的选项删除了空格。

例子

例子 1：

@DTW_STRIP("  day ", result)

返回：result = "day"

例子 2：

@DTW_STRIP("  day ", "T", result)

返回：result = " day"

例子 3：

@DTW_rSTRIP("  a day  ","L")

返回："a day "

DTW_SUBSTR

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回输入字符串的一个子串，其中可能带填充字符。

语法

@DTW_SUBSTR(stringIn, n, length, pad, stringOut)
@DTW_SUBSTR(stringIn, n, length, stringOut)
@DTW_SUBSTR(stringIn, n, stringOut)
@DTW_rSUBSTR(stringIn, n, length, pad)
@DTW_rSUBSTR(stringIn, n, length)
@DTW_rSUBSTR(stringIn, n)

参数

表 30. DTW_SUBSTR 参数

数据类型参数用法说明
字符串 stringIn IN 一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数 n IN 子串的开始字符位置。缺省情况是从 stringIn 的第一个字符开始。
整数 length IN 子串的字符个数。缺省值是字符串的剩余部分。
字符串 pad IN 当 n 大于 stringIn 的长度或长度超过 stringIn 的范围时，要使用的填充字符。缺省值是一个空格。
字符串 stringOut OUT 包含有 stringIn 的子串的一个变量。

例子

例子 1：

@DTW_SUBSTR("abc", "2", result)

返回：result = "bc"

例子 2：

@DTW_SUBSTR("abc", "2", "4", result)

返回：result = "bc "

例子 3：

@DTW_SUBSTR("abc", "2", "4", ".", result )

返回：result = "bc.."

例子 4:

@DTW_rSUBSTR("abc", "2", "6", ".")

返回："bc...."

DTW_TRANSLATE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

使用输入和输出转换表 tableI 和 tableO 来转换输入字符串中的字符。如果不指定参数列表中的 tableI、tableO 和 pad，则把 stringIn 转换为大写字符。如果指定了 tableI 和 tableO，但没有指定 pad，则在 tableI 中搜索输入字符串中的每个字符，并将它转换为 tableO 中的相应字符。如果在参数表中指定了 pad，则 stringIn 的长度和 stringOut 是相等的。当输入字符串中的某个字符在 tableI 中不存在时，使用 pad 字符。转换表可以为任何长度。如果不提供任何转换表，则只把输入字符串转换为大写。

语法

@DTW_TRANSLATE(stringIn, tableO, tableI, pad, stringOut)
@DTW_TRANSLATE(stringIn, tableO, tableI, stringOut)
@DTW_TRANSLATE(stringIn, tableO, stringOut)
@DTW_TRANSLATE(stringIn, stringOut)
@DTW_rTRANSLATE(stringIn, tableO, tableI, pad)
@DTW_rTRANSLATE(stringIn, tableO, tableI)
@DTW_rTRANSLATE(stringIn, tableO)
@DTW_rTRANSLATE(stringIn)

参数

表 31. DTW_TRANSLATE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 tableO IN 一个作为转换表使用的变量或文字串。使用空("")来指定 tableI 或 pad；否则此参数是可选的。
字符串 tableI IN 一个要在 stringIn 中搜索的变量或文字串。使用空("")来指定 pad；否则此参数是可选的。
字符串 pad IN 要使用的填充字符。缺省值是一个空格。
字符串 stringOut OUT 包含有 stringIn 的子串的一个变量。

例子

例子 1：

@DTW_TRANSLATE("abbc", result)

返回：result = "ABBC"

例子 2：

@DTW_TRANSLATE("abbc", "R", "bc", result)

返回：result = "aRR "

例子 3：

@DTW_rTRANSLATE("abcdef", "12", "abcd", ".")

返回："12..ef"

例子 4:

@DTW_rTRANSLATE("abbc", "", "", "")

返回："abbc"

DTW_UPPERCASE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

以大写形式返回一字符串。

语法

@DTW_UPPERCASE(stringIn, stringOut)
@DTW_rUPPERCASE(stringIn)
@DTW_mUPPERCASE(stringMult1, stringMult2, ..., stringMultn)

参数

表 32. DTW_UPPERCASE 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串，其中的字符可以是大写或小写。
字符串 stringOut OUT 一个包含 stringIn 的变量，其中所有的字符都为大写。
字符串 stringMult INOUT

输入：一个包含字符串的变量。
输出：一个包含输入字符串的变量，其中每个单引号(')字符都被替换成两个单引号。

例子

例子 1：

@DTW_UPPERCASE("Test", result)

返回：result = "TEST"

例子 2：

@DTW_rUPPERCASE(string1)

输入：string1 = "Web pages"
返回："WEB PAGES"

例子 3：

@DTW_mUPPERCASE(string1, string2, string3)

输入：string1 = "This", string2 = "is", string3 = "upper case"
返回：string1 = "THIS", string2 = "IS", string3 = "UPPER CASE"

字处理函数

这些函数是字符串函数的补充，用于修改单词或设置单词。Net.Data 将单词(字)解释为由空格分隔的字符串，或两边都有空格的字符串。例子如下：

字符串值单词个数
one two three 3
one , two , three 5
Part 2: Internet Sales Grow 5

DTW_DELWORD
DTW_SUBWORD
DTW_WORD
DTW_WORDINDEX
DTW_WORDLENGTH
DTW_WORDPOS
DTW_WORDS

DTW_DELWORD

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回输入字符串的一个子串。从第 n 个单词开始，删除由 length 指定个数的单词。

语法

@DTW_DELWORD(stringIn, n, length, stringOut)
@DTW_DELWORD(stringIn, n, stringOut)
@DTW_rDELWORD(stringIn, n, length)
@DTW_rDELWORD(stringIn, n)

参数

表 33. DTW_DELWORD 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 要删除的第一个单词的单词位置。
整数 length IN 要删除的单词个数。缺省情况是删除从 n 到 stringIn 结尾为止的所有单词。这是可选的参数。
字符串 stringOut OUT 包含有 stringIn 修改后结果的一个变量。

例子

例子 1：

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

返回：result = "Now is the time"

例子 2：

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

返回：result = "Now"

例子 3：

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

返回：result = "Now time"

例子 4:

@DTW_rDELWORD("Now is the time.", "3")

返回："Now is"

DTW_SUBWORD

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回输入字符串的一个子串。此子串从第 n 个单词开始，后面跟由 length 指定个数的单词。

语法

@DTW_SUBWORD(stringIn, n, length, stringOut)
@DTW_SUBWORD(stringIn, n, stringOut)
@DTW_rSUBWORD(stringIn, n, length)
@DTW_rSUBWORD(stringIn, n)

参数

表 34. DTW_SUBWORD 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 子串的第一个单词的单词位置。如果此值大于 stringIn 中的单词个数，则返回空。
整数 length IN 子串中的单词个数。如果这个值大于从第 n 个单词到 stringIn 结尾为止的单词总个数，则返回到 stringIn 结尾为止的所有单词。缺省情况是返回从第 n 个单词到 stringIn 结尾为止的所有单词。
字符串 stringOut OUT 包含有 stringIn 的子串的一个变量，此子串由 n 和 length 指定。

例子

例子 1：

@DTW_SUBWORD("Now is the   time", "5", result)

返回：result = ""

例子 2：

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

返回：result = "is the time"

例子 3：

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

返回：result = "is the"

例子 4:

@DTW_rSUBWORD("Now is the   time", "3")

返回："the time"

DTW_WORD

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从输入字符串的指定位置返回一个单词。

语法

@DTW_WORD(stringIn, n, stringOut)
@DTW_rWORD(stringIn, n)

参数

表 35. DTW_WORD 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 要返回的单词的单词位置。如果此值大于 stringIn 中的单词个数，则返回空。
字符串 stringOut OUT 包含第 n 个单词位置的单词的一个变量。

例子

例子 1：

@DTW_WORD("Now is the time", "3", result)

返回：result = "the"

例子 2：

@DTW_WORD("Now is the time", "5", result)

返回：result = ""

例子 3：

@DTW_rWORD("Now is the time", "4")

返回："time"

DTW_WORDINDEX

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回输入字符串的第 n 个单词的第一个字符的字符位置。

语法

@DTW_WORDINDEX(stringIn, n, stringOut)
@DTW_rWORDINDEX(stringIn, n)

参数

表 36. DTW_WORDINDEX 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 要索引的单词的单词位置。如果此值大于输入字符串中的单词个数，则返回 0。
字符串 stringOut OUT 包含 stringIn 中第 n 个单词的字符位置的一个变量。

例子

例子 1：

@DTW_WORDINDEX("Now is the time", "3", result)

返回：result = "8"

例子 2：

@DTW_WORDINDEX("Now is the time", "6", result)

返回：result = "0"

例子 3：

@DTW_rWORDINDEX("Now is the time", "2")

返回："5"

DTW_WORDLENGTH

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回输入字符串的第 n 个单词的长度。

语法

@DTW_WORDLENGTH(stringIn, n, stringOut)
@DTW_rWORDLENGTH(stringIn, n)

参数

表 37. DTW_WORDLENGTH 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
整数 n IN 要查询长度的那个单词的单词位置。如果此值大于输入字符串中的单词个数，则返回 0。
字符串 stringOut OUT 包含 stringIn 中第 n 个单词的长度值的一个变量。

例子

例子 1：

@DTW_WORDLENGTH("Now is the time", "1", result)

返回：result = "3"

例子 2：

@DTW_rWORDLENGTH("Now is the time", "6")

返回："0"

DTW_WORDPOS

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个字符串在另一个字符串中第一次出现的单词位置。在比较时将多个空格看作一个空格。这种比较是区别大小写的。

语法

@DTW_WORDPOS(stringIn1, stringIn2, n, stringOut)
@DTW_WORDPOS(stringIn1, stringIn2, stringOut)
@DTW_rWORDPOS(stringIn1, stringIn2, n)
@DTW_rWORDPOS(stringIn1, stringIn2)

参数

表 38. DTW_WORDPOS 参数

数据类型参数用法说明
字符串 stringIn1 IN 一个变量或文字串。
字符串 stringIn2 IN 一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数 n IN stringIn2 中要开始搜索的单词位置。如果此值大于 stringIn2 中的单词个数，则返回 0。缺省情况是从 stringIn2 的开头开始搜索。
字符串 stringOut OUT stringIn1 在 stringIn2 中的单词位置。

例子

例子 1：

@DTW_WORDPOS("the", "Now is the time", result)

返回：result = "3"

例子 2：

@DTW_WORDPOS("The", "Now is the time", result)

返回：result = "0"

例子 3：

@DTW_WORDPOS("The", "Now is the time", "5", result)

返回：result = "0"

例子 4:

@DTW_WORDPOS("is  the", "Now is     the time", result)

返回：result = "2"

例子 5：

@DTW_rWORDPOS("be", "To be or not to be", "3")

返回："6"

DTW_WORDS

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个字符串中的单词个数。

语法

@DTW_WORDS(stringIn, stringOut)
@DTW_rWORDS(stringIn)

参数

表 39. DTW_WORDS 参数

数据类型参数用法说明
字符串 stringIn IN 一个变量或文字串。
字符串 stringOut OUT 包含 stringIn 中的单词个数值的一个变量。

例子

例子 1：

@DTW_WORDS("Now is the time", result)

返回：result = "4"

例子 2：

@DTW_rWORDS(" ")

返回："0"

表格函数

这些函数用于简化 Net.Data 表格的处理，它比您使用 REXX、C 或 PERL 编写的函数更为有效。这些函数都要在示例宏 tbtest.mac 中使用。这个示例宏是与 Net.Data 工具包一起提供的。

DTW_TB_DLIST
DTW_TB_DUMPH
DTW_TB_DUMPV
DTW_TB_HTMLENCODE
DTW_TB_INPUT_CHECKBOX
DTW_TB_INPUT_RADIO
DTW_TB_INPUT_TEXT
DTW_TB_LIST
DTW_TB_SELECT
DTW_TB_TABLE
DTW_TB_TEXTAREA

DTW_TB_DLIST

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从宏表格中返回一个 HTML 定义列表。

语法

@DTW_TB_DLIST(table, term, def, termstyle, defstyle, anchor, anchor_u, image, image_u)

参数

表 40. DTW_TB_DLIST 参数

数据类型参数用法说明
数组 table IN 一个符号，指定了用于输出 HTML 定义列表的宏表格变量。
整数 term IN 表格中包含项目名称值(<DT> 标记后面的文本)的列号。缺省情况是使用第一列。
整数 def IN 表格中包含项目定义值(<DD 标记后面的文本)的列号。缺省情况是使用第二列。
字符串 termstyle IN 一个变量或文字串，其中包含用于项目名称值的 HTML 元素列表。缺省情况是不使用任何风格标记。
字符串 defstyle IN 一个变量或文字串，其中包含用于项目定义值的 HTML 元素列表。缺省情况是不使用任何风格标记。
字符串 anchor IN 指定要为哪些 HTML 元素生成锚引用(anchor reference)。有效值是 DT 和 DD。缺省情况是不生成锚引用。
整数 anchor_u IN 表格中的列号，其中包含了用于锚引用的 URL。缺省情况是不生成锚引用。
字符串 image IN 指定要为哪些 HTML 元素生成内嵌图象(inline image)。有效值是 DT 和 DD。缺省情况是不生成内嵌图象。
整数 image_u IN 表格中的列号，其中包含了用于内嵌图象的 URL。缺省情况是不生成内嵌图象。

例子

@DTW_TB_DLIST(Mytable,"3","4","b i","strong","DD","2","DT","1")
@DTW_TB_DLIST(Mytable,"","4","b","strong","DT","2","DT","1")
@DTW_TB_DLIST(Mytable,"3","4","","","DT","2")
@DTW_TB_DLIST(Mytable,"","","i","b","DD","2","DT","1")
@DTW_TB_DLIST(Mytable,"","3","","","DD","2","DT","1")
@DTW_TB_DLIST(Mytable,"3","4","EM","B U I","DT","2","DT","1")
@DTW_TB_DLIST(Mytable,"","4","","","DD","2","DT","1")
@DTW_TB_DLIST(Mytable,"3","","I","I","DT","2","DD","1")

例子 1：为第一个例子生成的 HTML 如下所示，这依赖于表格数据。

<DL>
<DT>
<IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b><i>image1text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor1.html"><strong>anchor1text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b><i>image2text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor2.html"><strong>anchor2text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b><i>image3text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor3.html"><strong>anchor3text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image4.gif" ALT=""><b><i>image4text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor4.html"><strong>anchor4text</strong></A>
</DT>
</DL>

DTW_TB_DUMPH

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个宏表格变量的内容。表格中的每一行显示在不同的行中。整个表格要用 <PRE></PRE> 标记括起来。

语法

@DTW_TB_DUMPH(table)

参数

表 41. DTW_TB_DUMPH 参数

数据类型参数用法说明
数组 table IN 一个符号，指定了要输出的宏表格变量。

例子

例子 1：

@DTW_TB_DUMPH(Mytable)

此例子生成的 HTML 看起来象：

<PRE>
姓名             部门                    职位
Jack Smith       Internet 技术           软件工程师
Helen Williams   数据库                  开发经理
Alex Jones       制造                    工业工程师
Tom Baker        采办                    销售员
</PRE>

DTW_TB_DUMPV

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个宏表格变量的内容。每一行在不同的行中。整个表格要用 <PRE></PRE> 标记括起来。

语法

@DTW_TB_DUMPV(table)

参数

表 42. DTW_TB_DUMPV 参数

数据类型参数用法说明
数组 table IN 一个符号，指定了要输出的宏表格变量。

例子

例子 1：

@DTW_TB_DUMPV(Mytable)

这个例子生成的 HTML 如下所示：

<PRE>
http://www.mycompany.com/images/image1.gif
http://www.mycompany.com/anchor1.html
image1text
anchor1text
http://www.mycompany.com/images/image2.gif
http://www.mycompany.com/anchor2.html
image2text
anchor2text
http://www.mycompany.com/images/image3.gif
http://www.mycompany.com/anchor3.html
image3text
anchor3text
http://www.mycompany.com/images/image4.gif
http://www.mycompany.com/anchor4.html
image4text
anchor4text
</PRE>

DTW_TB_HTMLENCODE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回带有已编码的 HTML 字符的输入宏表格。

&符号 & &
双引号 " "
大于 > >
小于 < <

语法

@DTW_TB_HTMLENCODE(table, collist)

参数

表 43. DTW_TB_HTMLENCODE 参数

数据类型参数用法说明
数组 table INOUT 要修改的宏表格变量。
字符串 collist IN 表格中要编码的列号。缺省情况是对所有列进行编码。

例子

例子 1：

@DTW_TB_HTMLENCODE(Mytable, "3 4")

在指定表格中第 3 和第 4 列中的特殊字符被它们的编码格式所替换。

DTW_TB_INPUT_CHECKBOX

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从一个宏表格变量返回一个或多个 HTML 校验框输入标记。

语法

@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows, checkedrows)

参数

表 44. DTW_TB_INPUT_CHECKBOX 参数

数据类型参数用法说明
数组 table IN 要作为校验框输入标记来显示的宏表格变量。
字符串 prompt IN 表格或字符串中的列号，其中包含了要在校验框旁边显示的文本。此参数是必需的，但可以是空("")值。当指定空值时，将使用为 namecol 定义的值。
字符串 namecol IN 表格或字符串中包含输入字段名称的列号。
字符串 valuecol IN 表格或字符串中包含输入字段值的列号。缺省值是 1。
字符串 rows IN 表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。
整数 checkedrows IN 一个行的列表，它指定了要选择表格中的哪些行。缺省情况是不选择字段。

例子

@DTW_TB_INPUT_CHECKBOX(Mytable,"","5")
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","5")
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","5","4")
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","5","","2 5")
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","4","","2 3 4","1 3 4")

最后一个例子生成的 HTML 如下所示：

<INPUT TYPE="CHECKBOX" NAME="anchor2text" VALUE="1">image2text<BR>
<INPUT TYPE="CHECKBOX" NAME="anchor3text" VALUE="1" CHECKED>image3text<BR>
<INPUT TYPE="CHECKBOX" NAME="anchor4text" VALUE="1" CHECKED>image4text<BR>

DTW_TB_INPUT_RADIO

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从一个宏表格变量返回一个或多个 HTML 选项框输入标记。

语法

@DTW_TB_INPUT_RADIO(table, prompt, namecol, valuecol, rows, checkedrows)

参数

表 45. DTW_TB_INPUT_RADIO 参数

数据类型参数用法说明
数组 table IN 要作为选项框输入标记来显示的宏表格变量。
字符串 prompt IN 表格或字符串中的列号，其中包含了要在选项旁边显示的文本。此参数是必需的，但可以是空("")值。当指定空值时，将使用 valuecol 的值。
字符串 namecol IN 表格或字符串中包含输入字段名称的列号。
字符串 valuecol IN 表格或字符串中包含输入字段值的列号。
字符串 rows IN 表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。
整数 checkedrows IN 表格中要显示校验标记的选项按钮所在的行号。只允许指定一个值。

例子

@DTW_TB_INPUT_RADIO(Mytable,"","Radio1","5")
@DTW_TB_INPUT_RADIO(Mytable,"3","Radio2","3")
@DTW_TB_INPUT_RADIO(Mytable,"3","Radio3","4")
@DTW_TB_INPUT_RADIO(Mytable,"3","Radio4","4","2 3 4","4")

为最后一个例子生成的 HTML 看起来如下：

<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor2text">image2text<BR>
<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor3text">image3text<BR>
<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor4text" CHECKED>image4text<BR>

DTW_TB_INPUT_TEXT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从 Net.Data 宏 TABLE 变量返回一个或多个输入文本标记。

语法

@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen, rows)

参数

表 46. DTW_TB_INPUT_TEXT 参数

数据类型参数用法说明
数组 table IN 要作为文本输入标记来显示的宏 TABLE 变量。
字符串 prompt IN 表格或字符串中的列号，其中包含了要在输入字段旁边显示的文本。如果显示一个空值("")，则不显示任何文本。
字符串 namecol IN 表格或字符串中包含输入字段名称的列号。
字符串 valuecol IN 表格或字符串中的列号，其中包含了为 VALUE 属性指定的缺省输入字段值。缺省情况是不生成 VALUE 属性值。
整数 size IN 输入字段的字符个数，这是为 SIZE 属性指定的。缺省值是最长的缺省输入值的长度，或为 10 (如果没有缺省的输入)。
整数 maxlen IN 输入字符串的最大长度，这是为 MAXLEN 属性指定的。缺省情况是不生成 MAXLENGTH 属性值。
整数 rows IN 表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。

例子

@DTW_TB_INPUT_TEXT(Mytable,"","5")
@DTW_TB_INPUT_TEXT(Mytable,"","5","4")
@DTW_TB_INPUT_TEXT(Mytable,"Enter title:","5","4")
@DTW_TB_INPUT_TEXT(Mytable,"3","5","4")
@DTW_TB_INPUT_TEXT(Mytable,"3","5","4","30")
@DTW_TB_INPUT_TEXT(Mytable,"3","5","4","35","40")
@DTW_TB_INPUT_TEXT(Mytable,"3","3","4","35","40","1 2 3")

为最后一个例子生成的 HTML 看起来如下：

<P>image1text
<INPUT TYPE="TEXT" NAME="image1text" VALUE="anchor1text" SIZE="35" MAXLENGTH="40">
<P>image2text
<INPUT TYPE="TEXT" NAME="image2text" VALUE="anchor2text" SIZE="35" MAXLENGTH="40">
<P>image3text
<INPUT TYPE="TEXT" NAME="image3text" VALUE="anchor3text" SIZE="35" MAXLENGTH="40">

DTW_TB_LIST

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个 HTML 列表。

语法

@DTW_TB_LIST(table, listtype, listitem, itemstyle, anchor_u, image_u)

参数

表 47. DTW_TB_LIST 参数

数据类型参数用法说明
数组 table IN 一个符号，指定了用于输出 HTML 列表的宏表格变量。
字符串 listtype IN 要生成的列表类型。可接受的列表类型包括：

DIR
MENU
OL
UL

整数 listitem IN 表格中包含列表值(<LI> 标记后的文本)的列号。缺省情况是使用第一列。
字符串 itemstyle IN 一个变量或文字串，其中包含用于项目名称值的 HTML 元素列表。缺省情况是不使用任何风格标记。
整数 anchor_u IN 表格中的列号，其中包含了用于锚引用的 URL。如果没有指定这个值，则不生成锚引用。
整数 image_u IN 表格中的列号，其中包含了用于内嵌图象的 URL。如果没有指定这个值，则不生成嵌入图象。

例子

@DTW_TB_LIST(Mytable,"MENU")
@DTW_TB_LIST(Mytable,"MENU","3")
@DTW_TB_LIST(Mytable,"UL","3","","2")
@DTW_TB_LIST(Mytable,"UL","4","B","2","1")
@DTW_TB_LIST(Mytable,"DIR","3","b i")
@DTW_TB_LIST(Mytable,"OL","4","TT", "U","2","1")

为最后一个例子生成的 HTML 看起来如下：

<TT><U>
<OL>
<LI><A HREF="http://www.mycompany.com/anchor1.html">
<IMG SRC="http://www.mycompany.com/images/image1.gif" ALT="">anchor1text</A>
<LI><A HREF="http://www.mycompany.com/anchor2.html">
<IMG SRC="http://www.mycompany.com/images/image2.gif" ALT="">anchor2text</A>
<LI><A HREF="http://www.mycompany.com/anchor3.html">
<IMG SRC="http://www.mycompany.com/images/image3.gif" ALT="">anchor3text</A>
<LI><A HREF="http://www.mycompany.com/anchor4.html">
<IMG SRC="http://www.mycompany.com/images/image4.gif" ALT="">anchor4txt</A>
</OL>
</U></TT>

DTW_TB_SELECT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

返回一个 HTML SELECT 菜单。

语法

@DTW_TB_SELECT(table, name, optioncol, size, multiple, rows, selectrows)

参数

表 48. DTW_TB_SELECT 参数

数据类型参数用法说明
数组 table IN 要作为 SELECT 字段来显示的宏表格变量。
字符串 name IN SELECT 字段中 NAME 属性的值。
整数 optioncol IN 表格中的列号，它的值将在 SELECT 字段的 OPTION 标记中使用。缺省情况是使用第一列。
整数 size IN 要在 SELECT 字段的 OPTION 标记中使用的表格行数。缺省情况是使用所有行。
字符串 multiple IN 指定是否允许多个选择。缺省值是 N，即不允许多个选择。
字符串 selectedrows IN 要在选择字段中使用的表格行。缺省情况是使用所有行。
字符串 rows IN 表格中的行列表，这些行的 OPTION 标记都将被选择。如果要指定多行，必须将“多个参数”选项设置为 Y。缺省值是使用第一个项目。

例子

@DTW_TB_SELECT(Mytable,"URL0")
@DTW_TB_SELECT(Mytable,"URL1","3")
@DTW_TB_SELECT(Mytable,"URL1","3","9")
@DTW_TB_SELECT(Mytable,"URL3","3","","y")
@DTW_TB_SELECT(Mytable,"URL4","2","3","y","2 4")
@DTW_TB_SELECT(Mytable,"URL5","3","","y","","2 5")
@DTW_TB_SELECT(Mytable,"URL6","3","","y","1 2 4","1 4")

为最后一个例子生成的 HTML 看起来如下：

<SELECT NAME="URL6" SIZE="3" MULTIPLE>
<OPTION SELECTED>image1text
<OPTION>image2text
<OPTION>image4text
</SELECT>

DTW_TB_TABLE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从一个宏表格变量返回一个 HTML 表格。

语法

@DTW_TB_TABLE(table, options, collist, cellstyle, anchor_u, image_u, url_text, url_style)

参数

表 49. DTW_TB_TABLE 参数

数据类型参数用法说明
数组 table IN 一个用于输出 HTML 表格的宏表格变量。
字符串 options IN TABLE 标记内部的表格属性。缺省情况是不使用任何属性。有效值包括：

BORDER
CELLSPACING
WIDTH

字符串 collist IN 表格中要在 HTML 表格中使用的列号。缺省情况是使用所有列。
字符串 cellstyle IN 在每个 TD 标记中的文本附近出现的 HTML 风格元素的一个列表，例如 B 和 I。缺省情况是不使用风格标记。
整数 anchor_u IN 表格中的列号，其中包含用于创建锚引用的 URL。同样必须在 collist 中指定列号。缺省情况是不生成锚引用标记。
整数 image_u IN 表格中的列号，其中包含用于创建内嵌图象的 URL。同样必须在 collist 中指定列号。缺省情况是不生成图象标记。
整数 url_text IN 表格中的列号，其中包含了用于显示锚引用或内嵌图象的文本。缺省情况是使用 URL 本身。
字符串 url_style IN HTML 风格元素的一个列表，这些风格用于在 url_text 中指定的文本。缺省情况是不生成风格标记。

例子

@DTW_TB_TABLE(Mytable,"BORDER","4 2 1","i","2","1","4","b")
@DTW_TB_TABLE(Mytable)
@DTW_TB_TABLE(Mytable,"BORDER")
@DTW_TB_TABLE(Mytable,"","3 4")
@DTW_TB_TABLE(Mytable,"BORDER","2 3 4","em")

为第一例子生成的 HTML 看起来象：

<TABLE BORDER>
<TR>
<TH>TITLE
<TH>ANCHORURL
<TH>IMAGEURL
<TR>
<TD><i>anchor1text</i>
<TD><A HREF="http://www.mycompany.com/anchor1.html"><b>anchor1text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b>anchor1text</b>
<TR>
<TD><i>anchor2text</i>
<TD><A HREF="http://www.mycompany.com/anchor2.html"><b>anchor2text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b>anchor2text</b>
<TR>
<TD><i>anchor3text</i>
<TD><A HREF="http://www.mycompany.com/anchor3.html"><b>anchor3text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b>anchor3text</b>
</TABLE>

DTW_TB_TEXTAREA

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

从一个宏表格变量返回 HTML TEXTAREA 标记。

语法

@DTW_TB_TEXTAREA(table, name, numrows, numcols, valuecol, rows)

参数

表 50. DTW_TB_TEXTAREA 参数

数据类型参数用法说明
数组 table IN 一个作为 TEXTAREA 标记使用的宏表格变量
字符串 name IN 文本区域的名称。
整数 numrows IN 要显示的行数。缺省值是表格的行数。
整数 numcols IN 要显示的列数。缺省值是表格中最长行的长度。
整数 valuecol IN 表格中的列号，它的值将在文本区域中显示。缺省值是第一列。
字符串 rows IN 表格中用于生成 TEXTAREA 标记的一组行。缺省情况是使用所有的行。

例子

@DTW_TB_TEXTAREA(Mytable,"textarea1")
@DTW_TB_TEXTAREA(Mytable,"textarea2","3")
@DTW_TB_TEXTAREA(Mytable,"textarea3","3","40")
@DTW_TB_TEXTAREA(Mytable,"textarea4","2","80","3")
@DTW_TB_TEXTAREA(Mytable,"textarea5","3","70","4","1 3 4")

为最后一个例子生成的 HTML 看起来如下：

<TEXTAREA NAME="textarea5" ROWS="3" COLS="70">
anchor1text
anchor3text
anchor4text
<TEXTAREA>

平面文件接口

平面文件接口是为大多数平台上的 DB2 而配置的一个语言环境。您可以打开、读取和处理平面文件源(一般文本)中的数据，也可以使用 Net.Data 宏中的函数将数据存储到平面文件中。

平面文件接口定界符

为了改进性能，您可以把一系列 SQL 请求所生成的 Net.Data 表格输出保留在一个平面文件中。然后就可以在后继的请求中检索此平面文件，而不需要重新发出 SQL 请求。

可以从 Net.Data 表格创建 Net.Data 平面文件；也可以从平面文件来构建 Net.Data 表格。为了实现表格和平面文件之间的转换，必须在表格列和平面文件的记录之间定义一种映射。定界符提供了一种方法，用于定义如何划分平面文件中的记录，如何映射到表格列中；以及如何将表格列映射成平面文件中的记录。

有两种类型的定界符：

换行字符 (ASCIITEXT): 当表格仅由一列组成时，可以使用这种转换。Net.Data 将相应的平面文件中的每个记录映射成表格中的一行。在这种情况下，仅使用正常的换行字符作为定界符，平面文件的记录之间就是用换行字符分隔的。
换行字符和定界字符串 (DELIMITED): 当表格由多列组成时，可以使用这种转换。当 Net.Data 从一个表格行创建一个平面文件记录时，它在项目之间放置定界字符串，以此作为分隔符。当 Net.Data 从平面文件重新建立表格时，它利用定界字符串来确定每行中有多少信息是要放入表格的一列中。在此情况下，用于在平面文件中划分不同记录的正常换行字符对应于表格中的行，而定界字符串划分了同一个记录中的不同项目。

您可以使用 DTWF_SEARCH 函数，在从 Net.Data 表格构建的平面文件中检索某些记录。在 DTWF_SEARCH 中指定一个字符串，以返回平面文件中包含此字符串的所有记录，以这些记录作为 Net.Data 表格中的行。

DTWF_APPEND

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

将表格变量的内容写到一个文件的结尾。

语法

@DTWF_APPEND(filename, transform, delimiter, table, retry, rows)

参数

表 51. DTWF_APPEND 参数

数据类型参数用法说明
字符串 filename IN 用于添加表格变量内容的文件名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 用于读取记录的表格变量。
整数 retry IN 不能立即追加文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 表格中要用于追加的最大行数。缺省情况是追加所有的行。指定 0 则添加所有的行。

例子

例子 1：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "DELIMITED", " ;", myTable)

例子 2：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable)

例子 3：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable, "0", "10")

DTWF_CLOSE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

关闭由 DTWF_OPEN 打开的文件。

语法

@DTWF_CLOSE(filename, retry)

参数

表 52. DTWF_CLOSE 参数

数据类型参数用法说明
字符串 filename IN 要关闭的文件名称。如果关闭成功，返回此文件的全路径名。
整数 retry IN 不能立即关闭文件时需要的重试次数。缺省情况是不重试。

例子

例子 1：

@DTWF_CLOSE(myFile, 5)

DTWF_DELETE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

从一个文件删除记录。(不删除空文件)。

语法

@DTWF_DELETE(filename, transform, delimiter, retry, rows, startrow)

参数

表 53. DTW_DELETE 参数

数据类型参数用法说明
字符串 filename IN 要删除记录的那个文件的名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
整数 retry IN 不能立即删除文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要删除的最大行数。缺省情况是删除所有的行。指定 0 则删除所有的行。
整数 startrow IN 开始执行删除操作的行号。值 1 表示从第一个行开始删除。如果这个值大于文件中的总行数，则将这个值更改为最后一个记录，并返回一个错误。缺省情况是从 1 开始。

例子

例子 1：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "5000"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Delimited", "|", myWait, myRows)

例子 2：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Asciitext", "|", "0", myRows, myStart)

DTWF_INSERT

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

在文件中插入记录。

语法

@DTWF_INSERT(filename, transform, delimiter, table, retry, rows, startrow)

参数

表 54. DTWF_INSERT 参数

数据类型参数用法说明
字符串 filename INOUT 用于插入记录的文件名称。返回此文件的全路径名。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 用于读取要插入的记录的表格变量。
整数 retry IN 不能立即写文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要从表格中插入的最大行数。缺省情况是插入所有的行。值 0 表示插入所有的行。
整数 startrow IN 开始执行插入操作的行号。值 1 表示在第一个行开始插入。如果这个值大于文件中的总行数，则将这个值更改为最后一个记录，并返回一个错误。缺省情况是从 1 开始。

例子

例子 1：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "3000"
%}
@DTWF_INSERT(myFile, "Delimited", "|", myTable, myWait)

例子 2：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_INSERT(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_OPEN

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

打开一个文件。文件打开后，直到调用 DTWF_CLOSE 函数才能关闭，这就允许诸如 DTWF_READ 和 DTWF_WRITE 函数可以自动打开文件，而无须调用 DTWF_OPEN。

语法

@DTWF_OPEN(filename, mode, retry)

参数

表 55. DTWF_OPEN 参数

数据类型参数用法说明
字符串 filename INOUT 要打开的文件名称。返回此文件的路径和名称。
字符串 mode IN 请求的访问类型：

r - 打开一个现有的文件，用于读。
w - 创建一个文件，用于写。(如果存在同名文件，则将破坏此文件)
a - 打开一个文件，用于追加。如果找不到此文件，Net.Data 将创建此文件。
r+ - 打开一个现有文件，用于读和写。
w+ - 创建一个文件，用于读和写。(如果存在同名文件，则将破坏此文件)
a+ - 以追加方式打开一个文件，用于读和写。如果找不到此文件，Net.Data 将创建此文件。

整数 retry IN 不能立即打开文件时需要的重试次数。缺省情况是不重试。

例子

例子 1：

%DEFINE{
  myFile = "c:/private/myfile"
  myMode = "r+"
%}
@DTWF_OPEN(myFile, myMode, "1000")

DTWF_READ

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

从一个文件中将记录读入一表格变量。

语法

@DTWF_READ(filename, transform, delimiter, table, retry, rows, startrow, columns)

参数

表 56. DTWF_READ 参数

数据类型参数用法说明
字符串 filename INOUT 要把记录读入表格变量的那个文件的名称。返回此文件的路径和名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 一个表格变量，用于写入从文件中读取的记录。
整数 retry IN 不能立即读取文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要读到表格中的文件记录的最大个数。缺省情况是读取所有记录，或直到表格填满为止。0 表示要读到文件结束。返回所生成的表格的行数。
整数 startrow IN 文件中开始读取记录的位置。缺省情况是从第一个记录开始。
整数 columns OUT 返回表格中的列数。

例子

例子 1：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait)

例子 2：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
  myColumns = ""
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait, myRows,
             myStartrow, myColumns)

例子 3：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_READ(myFile, "ASCIITEXT", ";", myTable, myColumns)
@DTW_TB_TABLE(myTable,"BORDER","")

DTWF_REMOVE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

删除整个文件。

语法

@DTWF_REMOVE(filename, retry)

参数

表 57. DTW_REMOVE 参数

数据类型参数用法说明
字符串 filename INOUT 要删除的文件名称。返回此文件的路径和名称。
整数 retry IN 不能立即删除文件时需要的重试次数。缺省情况是不重试。

例子

例子 1：

%DEFINE myFile = "c:/private/myfile"
@DTWF_REMOVE(myFile)

例子 2：

%DEFINE{
  myFile = "c:/private/myfile"
  myWait = "2000"
%}
@DTWF_REMOVE(myFile, myWait)

DTWF_SEARCH

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

返回对一个表格变量的字符串搜索结果。

语法

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry, rows, startrow)

参数

表 58. DTWF_SEARCH 参数

数据类型参数用法说明
字符串 filename INOUT 要搜索的文件名称。返回找到的文件路径和名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 用于存放搜索结果的表格变量。如果 transform 为 DELIMITED，则返回三列：

找到匹配的行号。
找到匹配的列号。
文件中匹配的列。

字符串 searchFor IN 要查找的字符串。
整数 retry IN 不能立即搜索文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要读到表格中的最大个数。缺省情况是读取所有的行，或直到表格填满为止。指定 0 表示要读到文件结束。此参数返回结果表格中的行数。
整数 startrow IN 文件中开始执行搜索操作的位置。缺省值是 1，表示从第一个记录开始搜索。

例子

例子 1：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
  mySearch = "0123456789abcdef"
@DTWF_SEARCH(myFile, "DELIMITED", ";",
               myTable, mySearch, myWait)

例子 2：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
  mySearch = "answer:"
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
%}
@DTWF_SEARCH(myFile, "DELIMITED", ";", myTable,
               mySearch, myWait, myRows, myStartrow)

DTWF_UPDATE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

从表格变量来更新文件中的记录。

语法

@DTWF_UPDATE(filename, transform, delimiter, table, retry, rows, startrow)

参数

表 59. DTWF_UPDATE 参数

数据类型参数用法说明
字符串 filename IN 要从表格变量更新其记录的文件名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 用于更新文件记录的表格变量。
整数 retry IN 不能立即写文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要从表格中更新的记录的最大个数。缺省情况是更新所有的记录。0 表示要更新文件中所有的行。
整数 startrow IN 要更新的第一个文件记录。缺省值是 1，表示要从文件开头开始更新。如果这个值大于文件中的记录个数，则将这个值更改为指向文件中的最后一个记录，并返回一个错误。

例子

例子 1：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myWait = "1500"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Delimited", "|", myTable, myWait, myRows)

例子 2：

%DEFINE{
   myFile = "c:/private/myfile"
   myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_WRITE

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

将一个表格变量的内容写入一个文件。

语法

@DTWF_WRITE(filename, transform, delimiter, table, retry, rows, startrow)

参数

表 60. DTWF_WRITE 参数

数据类型参数用法说明
字符串 filename IN 一个文件名称，用于写入表格变量中的记录。返回此文件的路径和名称。
字符串 transform IN 文件的格式：

ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。
DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。

字符串 delimiter IN 用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串 table IN 表格变量，用于把其中的行调出到文件。
整数 retry IN 不能立即写文件时需要的重试次数。缺省情况是不重试。
整数 rows IN 要写入的文件记录的最大个数。缺省情况是写整个表格。0 表示要将所有记录写到文件结束。
整数 startrow IN 开始写到文件中的第一个记录。缺省值是 1，表示要从第一个记录开始。如果指定的值超出了文件结束范围，则返回文件中的最后一行，并返回一个错误。

例子

例子 1：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "DELIMITED", ";", myTable)

例子 2：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000")

例子 3：

%DEFINE{
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000", "10", "50")

Web 注册表函数

Web 注册表是一个文件，由 Net.Data 维护着此文件的一个关键字，允许您方便地添加、检索和删除其中的条目。您可以在一个系统中创建多个 Net.Data Web 注册表。每个注册表有自己的名称，可以包含多个条目。Net.Data 提供了一些函数，用于维护注册表及其包含的条目。

DTWR_ADDENTRY
DTWR_CLEARREG
DTWR_CREATEREG
DTWR_DELENTRY
DTWR_DELREG
DTWR_LISTREG
DTWR_LISTSUB
DTWR_RTVENTRY
DTWR_UPDATEENTRY

注意:

当使用 OS/2 时，不要把星号(*)作为 registry、 registryVariable 和 registryData 参数的值。

DTWR_ADDENTRY

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

将一个条目添加至 Web 注册表。

语法

@DTWR_ADDENTRY(registry, registryVariable, registryData, index)

参数

表 61. DTWR_ADDENTRY 参数

数据类型参数用法说明
字符串 registry IN 要向其中添加条目的注册表名称。
字符串 registryVariable IN 要添加的注册表条目中 registryVariable 字符串部分的值。
字符串 registryData IN 要添加的注册表条目中 registryData 字符串部分的值。
字符串 index IN 要添加的索引条目中 registryVariable 字符串的索引部分的值。此参数是可选的。如果指定此参数，则将一个索引项添加到指定的注册表。

例子

例子 1：

@DTWR_ADDENTRY("Myregistry", "Jones", "http://Advantis.com/~Jones/webproj")

例子 2：

@DTWR_ADDENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/",
     "WORK_URL,")

DTWR_CLEARREG

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X
X X X X

从 Web 注册表中清除条目。

语法

@DTWR_CLEARREG(registry)

参数

表 62. DTWR_CLEARREG 参数

数据类型参数用法说明
字符串 registry IN 要清除的注册表名称。

例子

例子 1：

@DTWR_CLEARREG("Myregistry")

DTWR_CREATEREG

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

创建一个新的 Web 注册表。

语法

@DTWR_CREATEREG(registry, security)

参数

表 63. DTWR_CREATEREG 参数

数据类型参数用法说明
字符串 registry IN 要创建的注册表名称。
字符串 security IN 用于创建注册表的安全性类型。在 Unix 平台中，缺省的安全性与注册表所在目录的安全性相同。必须为 3 个安全性组指定安全性：用户、组和公共。R 表示具有读许可权，W 表示具有写许可权，而 X 表示具有执行许可权。例如，如果要对三个组都指定全部权限，可以指定此参数为 *RWX, *RWX, *RWX。 .

例子

例子 1：

@DTWR_CREATEREG("myRegistry")

例子 2：

@DTWR_CREATEREG("URLLIST", "*RWX, *RWX, *R")

DTWR_DELENTRY

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

将 Web 注册表删除一个条目。

语法

@DTWR_DELENTRY(registry, registryVariable, index)

参数

表 64. DTWR_DELENTRY 参数

数据类型参数用法说明
字符串 registry IN 要从中移去条目的注册表名称。
字符串 registryVariable IN 要移去的条目中 registryVariable 字符串部分的值。
字符串 index IN 索引条目中 registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则从注册表移去索引项。

例子

例子 1：

@DTWR_DELENTRY("Myregistry", "Jones")

例子 2：

@DTWR_DELENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_DELREG

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

删除一个 Web 注册表。

语法

@DTWR_DELREG(registry)

参数

表 65. DTWR_DELREG 参数

数据类型参数用法说明
字符串 registry IN 要删除的注册表名称。

例子

例子 1：

@DTWR_DELREG("Myregistry")

DTWR_LISTREG

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

列出整个 Web 注册表。

它在由用户传递的 OUT 表格变量中返回关于注册表条目的信息。此表格变量是在作为参数传递到 FUNCTION 模块执行 LISTREG 注册表操作以前，在用户宏中定义的。如果对于表格中的最大行数，用户使用 ALL 选项来定义表格变量，则此操作列出了表格中所有可用的注册表条目，每个表格行一个。另一方面，如果用户指定表格中的最大行数为值 X, 但在指定的注册表中有多于 X 个条目，则只列出前面的 X 个条目，并发回一个错误代码，表示由于没有足够的表格行用于列出更多的条目，现在只能列出一个部分列表。如果值 X 超过了指定的注册表中的可用条目数，则列出所有条目。在表格中总是有 2 列。由 Web 注册表语言环境指定表格的列标题为 "REGISTRY_VARIABLE" 和 "REGISTRY_DATA"。

语法

@DTWR_LISTREG(registry, registryTable)

参数

表 66. DTWR_LISTREG 参数

数据类型参数用法说明
字符串 registry IN 要列出的注册表名称。
字符串 registryTable OUT 用于存放注册表条目的表格变量的名称。

例子

例子 1：

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTREG("URLLIST", RegistryTable)

DTWR_LISTSUB

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT

X

列出 Web 注册表中的立即子密钥条目。

它在由用户传递的 OUT 表格变量中返回关于注册表条目的信息。此表格变量是在作为参数传递到 LISTSUBG 注册表操作以前，在用户宏中定义的。如果对于表格中的最大行数，用户使用 ALL 选项来定义表格变量，则此操作列出了表格中所有可用的注册表条目，每个表格行一个。另一方面，如果用户指定表格中的最大行数为值 X, 但在指定的注册表中有多于 X 个条目，则只列出前面的 X 个条目，并发回一个错误代码，表示由于没有足够的表格行用于列出更多的条目，现在只能列出一个部分列表。如果值 X 超过了指定的注册表中的可用条目数，则列出所有条目。在表格中总是只有一列。表格的列标题设置为 "REGISTRY_SUBKEY"。

只有在与 Windows95 “系统注册表”兼容的操作系统中，此函数才有效。

语法

@DTWR_LISTSUB(registry, registryTable)

参数

表 67. DTWR_LISTSUB 参数

数据类型参数用法说明
字符串 registry IN 要列出的注册表名称。
字符串 registryTable OUT 用于存放注册表条目的表格变量的名称。

例子

例子 1：

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTSUB("URLLIST", RegistryTable)

DTWR_RTVENTRY

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

从 Web 注册表条目中检索 registryData 字符串。

语法

@DTWR_RTVENTRY(registry, registryVariable, registryData, index)
@DTWR_rRTVENTRY(registry, registryVariable, index)

参数

表 68. DTWR_RTVENTRY 参数

数据类型参数用法说明
字符串 registry IN 要在其中检索条目的注册表名称。
字符串 registryVariable IN 要检索 registryData 字符串的注册表条目中 registryVariable 字符串部分的值。
字符串 registryData OUT 返回与 registryVariable 相匹配的注册表条目中 registryData 字符串部分的值。
字符串 index IN 要返回 registryData 字符串的索引条目中，registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则返回索引条目的 registryData 字符串。

例子

例子 1：

%DEFINE RegistryData = ""
@DTWR_RTVENTRY("Myregistry", "Jones", RegistryData)

例子 2：

@DTWR_RTVENTRY("URLLIST", "SMITH", RegistryData, "WORK_URL")

例子 3：

@DTWR_rRTVENTRY("Myregistry", "Jones")

例子 4:

@DTWR_rRTVENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_UPDATEENTRY

目的

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

将指定的注册表条目中现有的 registryData 字符串替换为由调用者指定的新值。不能更改 registerVariable 字符串。

语法

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

参数

表 69. DTWR_UPDATEENTRY 参数

数据类型参数用法说明
字符串 registry IN 要更新其条目的注册表的名称。
字符串 registryVariable IN 要更新的注册表条目中 registryVariable 字符串部分的值。
字符串 newData IN 要更新的注册表条目中 registryData 字符串部分的新值。
字符串 index IN 要更新的索引条目中 registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则更新索引条目。

例子

例子 1：

@DTWR_UPDATEENTRY("Myregistry", "Jones", "http://advantis.com/~Jones/personal")

例子 2：

@DTWR_UPDATEENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/personal", "WORK_URL")

[ 页的顶部 | 上一页 | 下一页 | 内容表 | 索引 ]

字符	名称	代码
SPACE	空格
"	双引号	"
#	数值符号	#
%	百分号	%
&	&符号	&
/	反斜杠	\
:	冒号	:
;	分号	;
<	小于	<
=	等于	&#61:
>	大于	&#62:
?	问号	&#63:
@	@符号	@
[	左方括号	(
\	斜杠	/
]	右方括号	)
^	^符号	^
{	左花括号	{
\|	竖线	\|
}	右花括号	}
~	~符号	~

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个变量或文字串，其中的字符可以是大写或小写。
字符串	`stringOut`	OUT	一个包含 stringIn 的变量，其中所有的字符都为小写。
字符串	`stringMult`	INOUT	输入：一个包含字符串的变量。输出：一个包含输入字符串的变量，其中的所有字符都已转换为大写。

数据类型	参数	用法	说明
字符串	`stringIn1`	IN	一个要搜索的变量或文字串。
字符串	`stringIn2`	IN	一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数	`n`	IN	stringIn2 中要开始搜索的字符位置。缺省值是从 stringIn2 的第一个字符开始搜索。
整数	`nOut`	OUT	包含 stringIn1 在 stringIn2 中第一次出现的位置值的一个变量。如果找不到这种串，就返回 0。

数据类型	参数	用法	说明
字符串	`stringIn`	IN	一个要倒置的变量或文字串。
字符串	`stringOut`	OUT	一个包含倒置后的 stringIn 的变量。

字符串值	单词个数
one two three	3
one , two , three	5
Part 2: Internet Sales Grow	5

数据类型	参数	用法	说明
数组	`table`	IN	一个符号，指定了用于输出 HTML 定义列表的宏表格变量。
整数	`term`	IN	表格中包含项目名称值(`<DT>` 标记后面的文本)的列号。缺省情况是使用第一列。
整数	`def`	IN	表格中包含项目定义值(`<DD` 标记后面的文本)的列号。缺省情况是使用第二列。
字符串	`termstyle`	IN	一个变量或文字串，其中包含用于项目名称值的 HTML 元素列表。缺省情况是不使用任何风格标记。
字符串	`defstyle`	IN	一个变量或文字串，其中包含用于项目定义值的 HTML 元素列表。缺省情况是不使用任何风格标记。
字符串	`anchor`	IN	指定要为哪些 HTML 元素生成锚引用(anchor reference)。有效值是 DT 和 DD。缺省情况是不生成锚引用。
整数	`anchor_u`	IN	表格中的列号，其中包含了用于锚引用的 URL。缺省情况是不生成锚引用。
字符串	`image`	IN	指定要为哪些 HTML 元素生成内嵌图象(inline image)。有效值是 DT 和 DD。缺省情况是不生成内嵌图象。
整数	`image_u`	IN	表格中的列号，其中包含了用于内嵌图象的 URL。缺省情况是不生成内嵌图象。

数据类型	参数	用法	说明
数组	`table`	IN	要作为校验框输入标记来显示的宏表格变量。
字符串	`prompt`	IN	表格或字符串中的列号，其中包含了要在校验框旁边显示的文本。此参数是必需的，但可以是空("")值。当指定空值时，将使用为 namecol 定义的值。
字符串	`namecol`	IN	表格或字符串中包含输入字段名称的列号。
字符串	`valuecol`	IN	表格或字符串中包含输入字段值的列号。缺省值是 1。
字符串	`rows`	IN	表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。
整数	`checkedrows`	IN	一个行的列表，它指定了要选择表格中的哪些行。缺省情况是不选择字段。

数据类型	参数	用法	说明
数组	`table`	IN	要作为选项框输入标记来显示的宏表格变量。
字符串	`prompt`	IN	表格或字符串中的列号，其中包含了要在选项旁边显示的文本。此参数是必需的，但可以是空("")值。当指定空值时，将使用 valuecol 的值。
字符串	`namecol`	IN	表格或字符串中包含输入字段名称的列号。
字符串	`valuecol`	IN	表格或字符串中包含输入字段值的列号。
字符串	`rows`	IN	表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。
整数	`checkedrows`	IN	表格中要显示校验标记的选项按钮所在的行号。只允许指定一个值。

数据类型	参数	用法	说明
数组	`table`	IN	要作为文本输入标记来显示的宏 TABLE 变量。
字符串	`prompt`	IN	表格或字符串中的列号，其中包含了要在输入字段旁边显示的文本。如果显示一个空值("")，则不显示任何文本。
字符串	`namecol`	IN	表格或字符串中包含输入字段名称的列号。
字符串	`valuecol`	IN	表格或字符串中的列号，其中包含了为 VALUE 属性指定的缺省输入字段值。缺省情况是不生成 VALUE 属性值。
整数	`size`	IN	输入字段的字符个数，这是为 SIZE 属性指定的。缺省值是最长的缺省输入值的长度，或为 10 (如果没有缺省的输入)。
整数	`maxlen`	IN	输入字符串的最大长度，这是为 MAXLEN 属性指定的。缺省情况是不生成 MAXLENGTH 属性值。
整数	`rows`	IN	表格中要从中生成输入字段的行的列表。缺省情况是使用所有的行。

数据类型	参数	用法	说明
数组	`table`	IN	一个符号，指定了用于输出 HTML 列表的宏表格变量。
字符串	`listtype`	IN	要生成的列表类型。可接受的列表类型包括： DIR MENU OL UL
整数	`listitem`	IN	表格中包含列表值(<LI> 标记后的文本)的列号。缺省情况是使用第一列。
字符串	`itemstyle`	IN	一个变量或文字串，其中包含用于项目名称值的 HTML 元素列表。缺省情况是不使用任何风格标记。
整数	`anchor_u`	IN	表格中的列号，其中包含了用于锚引用的 URL。如果没有指定这个值，则不生成锚引用。
整数	`image_u`	IN	表格中的列号，其中包含了用于内嵌图象的 URL。如果没有指定这个值，则不生成嵌入图象。

数据类型	参数	用法	说明
数组	`table`	IN	要作为 SELECT 字段来显示的宏表格变量。
字符串	`name`	IN	SELECT 字段中 NAME 属性的值。
整数	`optioncol`	IN	表格中的列号，它的值将在 SELECT 字段的 OPTION 标记中使用。缺省情况是使用第一列。
整数	`size`	IN	要在 SELECT 字段的 OPTION 标记中使用的表格行数。缺省情况是使用所有行。
字符串	`multiple`	IN	指定是否允许多个选择。缺省值是 N，即不允许多个选择。
字符串	`selectedrows`	IN	要在选择字段中使用的表格行。缺省情况是使用所有行。
字符串	`rows`	IN	表格中的行列表，这些行的 OPTION 标记都将被选择。如果要指定多行，必须将“多个参数”选项设置为 Y。缺省值是使用第一个项目。

数据类型	参数	用法	说明
数组	`table`	IN	一个用于输出 HTML 表格的宏表格变量。
字符串	`options`	IN	TABLE 标记内部的表格属性。缺省情况是不使用任何属性。有效值包括： BORDER CELLSPACING WIDTH
字符串	`collist`	IN	表格中要在 HTML 表格中使用的列号。缺省情况是使用所有列。
字符串	`cellstyle`	IN	在每个 TD 标记中的文本附近出现的 HTML 风格元素的一个列表，例如 B 和 I。缺省情况是不使用风格标记。
整数	`anchor_u`	IN	表格中的列号，其中包含用于创建锚引用的 URL。同样必须在 collist 中指定列号。缺省情况是不生成锚引用标记。
整数	`image_u`	IN	表格中的列号，其中包含用于创建内嵌图象的 URL。同样必须在 collist 中指定列号。缺省情况是不生成图象标记。
整数	`url_text`	IN	表格中的列号，其中包含了用于显示锚引用或内嵌图象的文本。缺省情况是使用 URL 本身。
字符串	`url_style`	IN	HTML 风格元素的一个列表，这些风格用于在 url_text 中指定的文本。缺省情况是不生成风格标记。

数据类型	参数	用法	说明
数组	`table`	IN	一个作为 TEXTAREA 标记使用的宏表格变量
字符串	`name`	IN	文本区域的名称。
整数	`numrows`	IN	要显示的行数。缺省值是表格的行数。
整数	`numcols`	IN	要显示的列数。缺省值是表格中最长行的长度。
整数	`valuecol`	IN	表格中的列号，它的值将在文本区域中显示。缺省值是第一列。
字符串	`rows`	IN	表格中用于生成 TEXTAREA 标记的一组行。缺省情况是使用所有的行。

数据类型	参数	用法	说明
字符串	`filename`	IN	用于添加表格变量内容的文件名称。
字符串	`transform`	IN	文件的格式： ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。 DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。
字符串	`delimiter`	IN	用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串	`table`	IN	用于读取记录的表格变量。
整数	`retry`	IN	不能立即追加文件时需要的重试次数。缺省情况是不重试。
整数	`rows`	IN	表格中要用于追加的最大行数。缺省情况是追加所有的行。指定 0 则添加所有的行。

数据类型	参数	用法	说明
字符串	`filename`	IN	要关闭的文件名称。如果关闭成功，返回此文件的全路径名。
整数	`retry`	IN	不能立即关闭文件时需要的重试次数。缺省情况是不重试。

数据类型	参数	用法	说明
字符串	`filename`	IN	要删除记录的那个文件的名称。
字符串	`transform`	IN	文件的格式： ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。 DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。
字符串	`delimiter`	IN	用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
整数	`retry`	IN	不能立即删除文件时需要的重试次数。缺省情况是不重试。
整数	`rows`	IN	要删除的最大行数。缺省情况是删除所有的行。指定 0 则删除所有的行。
整数	`startrow`	IN	开始执行删除操作的行号。值 1 表示从第一个行开始删除。如果这个值大于文件中的总行数，则将这个值更改为最后一个记录，并返回一个错误。缺省情况是从 1 开始。

数据类型	参数	用法	说明
字符串	`filename`	IN	要从表格变量更新其记录的文件名称。
字符串	`transform`	IN	文件的格式： ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。 DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。
字符串	`delimiter`	IN	用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串	`table`	IN	用于更新文件记录的表格变量。
整数	`retry`	IN	不能立即写文件时需要的重试次数。缺省情况是不重试。
整数	`rows`	IN	要从表格中更新的记录的最大个数。缺省情况是更新所有的记录。0 表示要更新文件中所有的行。
整数	`startrow`	IN	要更新的第一个文件记录。缺省值是 1，表示要从文件开头开始更新。如果这个值大于文件中的记录个数，则将这个值更改为指向文件中的最后一个记录，并返回一个错误。

数据类型	参数	用法	说明
字符串	`filename`	IN	一个文件名称，用于写入表格变量中的记录。返回此文件的路径和名称。
字符串	`transform`	IN	文件的格式： ASCIITEXT - 将表格写入文件，在两个列值之间使用换行字符，并忽略定界符参数。 DELIMITED - 将表格写入文件，并在定界符参数中指定定界符。
字符串	`delimiter`	IN	用于表示一个值结束的字符串。这个参数是区别大小写的。如果 transform 为 ASCIITEXT，则忽略此参数。
字符串	`table`	IN	表格变量，用于把其中的行调出到文件。
整数	`retry`	IN	不能立即写文件时需要的重试次数。缺省情况是不重试。
整数	`rows`	IN	要写入的文件记录的最大个数。缺省情况是写整个表格。0 表示要将所有记录写到文件结束。
整数	`startrow`	IN	开始写到文件中的第一个记录。缺省值是 1，表示要从第一个记录开始。如果指定的值超出了文件结束范围，则返回文件中的最后一行，并返回一个错误。

数据类型	参数	用法	说明
字符串	`registry`	IN	要向其中添加条目的注册表名称。
字符串	`registryVariable`	IN	要添加的注册表条目中 registryVariable 字符串部分的值。
字符串	`registryData`	IN	要添加的注册表条目中 registryData 字符串部分的值。
字符串	`index`	IN	要添加的索引条目中 registryVariable 字符串的索引部分的值。此参数是可选的。如果指定此参数，则将一个索引项添加到指定的注册表。

数据类型	参数	用法	说明
字符串	`registry`	IN	要创建的注册表名称。
字符串	`security`	IN	用于创建注册表的安全性类型。在 Unix 平台中，缺省的安全性与注册表所在目录的安全性相同。必须为 3 个安全性组指定安全性：用户、组和公共。R 表示具有读许可权，W 表示具有写许可权，而 X 表示具有执行许可权。例如，如果要对三个组都指定全部权限，可以指定此参数为 `RWX, RWX, *RWX`。 .

数据类型	参数	用法	说明
字符串	`registry`	IN	要从中移去条目的注册表名称。
字符串	`registryVariable`	IN	要移去的条目中 registryVariable 字符串部分的值。
字符串	`index`	IN	索引条目中 registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则从注册表移去索引项。

数据类型	参数	用法	说明
字符串	`registry`	IN	要列出的注册表名称。
字符串	`registryTable`	OUT	用于存放注册表条目的表格变量的名称。

数据类型	参数	用法	说明
字符串	`registry`	IN	要在其中检索条目的注册表名称。
字符串	`registryVariable`	IN	要检索 registryData 字符串的注册表条目中 registryVariable 字符串部分的值。
字符串	`registryData`	OUT	返回与 registryVariable 相匹配的注册表条目中 registryData 字符串部分的值。
字符串	`index`	IN	要返回 registryData 字符串的索引条目中，registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则返回索引条目的 registryData 字符串。

数据类型	参数	用法	说明
字符串	`registry`	IN	要更新其条目的注册表的名称。
字符串	`registryVariable`	IN	要更新的注册表条目中 registryVariable 字符串部分的值。
字符串	`newData`	IN	要更新的注册表条目中 registryData 字符串部分的新值。
字符串	`index`	IN	要更新的索引条目中 registryVariable 字符串的索引部分的值。这是一个可选参数。如果指定此参数，则更新索引条目。