PB函数大全.doc

1、 PB 函数大全 Abs() 功能计算绝对值。 语法 Abs ( n ) 参数 n：要得到绝对值的数值型变量或表达式返回值返回值的数据类型与 n 的数据类型相同，函数执行成功时返回 n 的绝对值。如果参数 n 的值为 NULL， Abs()函数返回 NULL。 Ceiling() 功能返回大于 n 的最小整数。 语法 Ceiling ( n ) 参数 n：数值型变量或表达式返回值返回值的数据类型与 n 的数据类型相同。函数执行成功时返回大于 n 的最小整数。如果参数 n 的值为 NULL， Ceiling()函数返回 NULL。 Cos() 功能计算余 弦，其中参数以弧度为单位。 语法 Cos

2、 ( n ) 参数 n：数值型变量或表达式返回值 Double。函数执行成功时返回 n 的余弦。如果参数 n 的值为NULL， Cos()函数返回 NULL。 Exp() 功能计算 e 的 n 次方。 语法 Exp ( n ) 参数 n：指定幂值返回值 Double。函数执行成功时返回 e（约等于 2.71828）的 n 次方。如果参数 n 的值为 NULL， Exp()函数返回 NULL。 Fact() 功能计算 n 的阶乘。 语法 Fact ( n ) 参数 n：数值型变量或表达式返回值 Double。函数执行成功时返 回 n 的阶乘。如果参数 n 的值为NULL， Fact()函数返回

3、NULL。 Int() 功能得到小于等于 n 的最大整数。 语法 Int ( n ) 参数 n：数值型变量或表达式返回值 Integer。函数执行成功时返回小于等于 n 的最大整数。如果n 的值太小或太大，超过了整数的表示范围，则函数返回 0。如果参数 n 的值为 NULL， Int()函数返回 NULL。 Log() 功能计算 n 的自然对数。 语法 Log ( n ) 参数 n：数值型变量或表达式，其值必须大于 0 返回值 Double。函数执行成功时返回 n 的自然对数。如果 n 小于等于 0，将导致运行错误。如果参数 n 的值为 NULL， Log()函数返回 NULL。 LogTen

4、() 功能计算 n 的常用对数（以 10 为底）。 语法 LogTen ( n ) 参数 n：数值型变量或表达式，其值必须大于 0 返回值 Double。函数执行成功时返回 n 的常用对数。如果 n 小于等于 0，将导致运行错误。如果参数 n 的值为 NULL， LogTen()函数返回 NULL。 Max() 功能求两个数中的最大值。 语法 Max ( x, y ) 参数 x：数值型变量或表达式，参加比较的第一个数 y ：数值型变量或表达式，参加比较的第二个数返回值以 x、 y 中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中更大者。如果任何参数的值

5、为 NULL， Max()函数返回 NULL。 Min() 功能求两个数中的最小值。 语法 Min( x, y ) 参数 x：数值型变量或表达式，参加比较的第一个数 y ：数值型变量或表达式，参加比较的第二个数返回值以 x、 y 中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中较小者。如果任何参数的值为 NULL， Min()函数返回 NULL。 Mod() 功能求余数。 语法 Mod ( x, y ) 参数 x：数值型变量或表达式，被除数 y ：数值型变量或表达式，除数返回值以 x、 y 中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行

6、成功时返回 x 除以 y 所得的余数 。如果任何参数的值为 NULL， Mod()函数返回 NULL。 Pi() 功能计算 n 与 Pi(3.14159265358979323.)的乘积。 语法 Pi ( n ) 参数 n：数值型变量或表达式返回值 Double。函数执行成功时返回 n 与 Pi(3.14159265358979323.)的乘积 。发生错误时返回 -1。如果参数 n 的值为 NULL， Pi()函数返回 NULL。 Rand() 功能得到 1 与 n 之间的一个伪随机数。 语法 Rand ( n ) 参数 n：数值型变量或表达式，指定要产生的伪随机数的上界。有效值在 1 到 3

7、2,767 之间返回值与 n 的数据类型相同。函数执行成功时返回 1 与 n 之间的一个伪随机数，包括 1 和 n 在内。如果参数 n 的值为 NULL， Rand()函数返回 NULL。 Randomize() 功能初始化伪随机数发生器，这样让应用程序每次使用不同的伪随机数序列。 语法 Randomize ( n ) 参数 n：数值型变量或表达式，指定伪随机数生成器使用的起始值，不同的起始值可以生成不同的伪随机数序列。当 n 的值为 0 时，该函数把系统时钟作为伪随机数生成器的起始值，这样可以生成不可重复的伪随机数序列。当 n 的值不为 0 时，可以产生不同的伪随机数序列，但是，如果两次使用

8、相同的伪随机数生成器起始值，那么两次生成的伪随机数序列相同。 n 的值在 0 到 32,767 之间返回值 Integer。极少使用该函数的返回值。 Round() 功能将 x 四舍五入到 n 位。 语法 Round ( x, n )参数 x：要四舍五入的数值型数据 n：整数 类型，指定从哪个小数位上四舍五入 x。有效值在 0 到 18 之间返回值 Decimal。函数执行成功时返回将 x 四舍五入到小数点后第 n 位的数值，如果函数执行失败或任何参数的值为 NULL， Round()函数返回 NULL。 Sign() 功能确定 n 是整数、负数还是零。 语法 Sign ( n ) 参数 n：

9、数值型变量或表达式，指定要测试符号的值返回值 Integer。当 n 大于 0时返回 1；当 n 小于 0时返回 -1；当 n 等于 0 时返回 0。如果参数 n 的值为 NULL， Sign()函数返回 NULL。 Sin() 功能计算正弦，其中参数以弧度 为单位。 语法 Sin( n ) 参数 n：数值型变量或表达式返回值 Double。函数执行成功时返回 n 的正弦。如果参数 n 的值为 NULL，Sin()函数返回 NULL。 Sqrt() 功能计算平方根。 语法 Sqrt ( n ) 参数 n：数值型变量或表达式，指定要计算平方根的数据返回值 Double。函数执行成功时返回 n 的

10、平方根。如果 n 是负数，则执行该函数时引发运行错误。如果参数 n 的值为 NULL， Sqrt()函数返回 NULL。 Tan() 功能计算正切，其中参数以弧度为单位。 语法 Tan( n ) 参数 n：数值型变 量或表达式返回值 Double。函数执行成功时返回 n 的正切。如果参数 n 的值为 NULL，Tan()函数返回 NULL。 Truncate() 功能截断数值到指定的小数位。 语法 Truncate ( x, n ) 参数 x：要截断的数值型数据 n：整数类型，指定从哪个小数位上截断 x。有效值在 0 到 18 之间返回值 Decimal。函数执行成功时返回将 x 截断到小数点

11、后第 n 位的数值，如果函数执行失败或任何参数的值为 NULL， Truncate()函数返回 NULL。所谓截断就是舍弃指定位之后的数值。 Asc() 功能得到字符 串第一个字符的 ASCII 码整数值。 语法 Asc ( string ) 参数 string：要得到第一个字符 ASCII 值的字符串返回值 Integer。函数执行成功时返回 string参数第一个字符的 ASCII 值，如果 string 参数的值为 NULL，则 Asc()函数返回 NULL。 Char() 功能将字符串的第一个字符、 Blob 变量的第一个值、或一个整数转换成字符。 语法 Char ( n ) 参数 n

12、：字符串、 Blob 变量或整数，也可以是包含上述类型数据的 Any 类型变量返回值 Char。返回参数n 的第一个字符。如果 n 参数的值为 NULL，则 Char()函数返回 NULL。 Dec() 功能将字符串或 Blob 值转换成 Decimal类型的值。 语法 Dec ( stringorblob ) 参数 stringorblob： string 类型变量或 Blob 类型变量。 Blob 类型变量时，把该变量第一个值转换为 Decimal类型的值，其余部分被忽略。 stringorblob 参数也可以是包含上述类型数据的 Any 类型变量返回值Decimal。函数执行成功时返回相

13、应的 Decimal类型值。如果 stringorblob 参数中的值不是有效的 PowerScript 数字或数据类型不兼容，那么 Dec()函数返回 0。如果 stringorblob参数的值为 NULL，则 Dec()函数返回 NULL。 Double() 功能将字符串或 Blob 值转换成 Double 类型的值。 语法 Double(stringorblob) 参数 stringorblob： string 类型变量或 Blob 类型变量。 Blob 类型变量时，把该变量第一个值转换为 Double 类型的值，其余部分被忽略。 stringorblob参数也可以是包含上述类型数据的

14、Any 类型变量返回值Double。函数执行成 功时返回相应的 Double 类型值。如果 stringorblob 参数中的值不是有效的 PowerScript 数字或数据类型不兼容，那么 Double()函数返回 0。如果 stringorblob参数的值为 NULL，则 Double()函数返回 NULL。 Integer() 功能 将字符串或 Blob 值转换成 Integer 类型的值。 语法 Integer ( stringorblob ) 参数 stringorblob： string 类型变量或 Blob 类型变量。 Blob 类型变量时，把该变量第一个值转换为 Integer

15、 类型的值 ，其余部分被忽略。 stringorblob 参数也可以是包含上述类型数据的 Any 类型变量返回值Integer。函数执行成功时返回相应的 Integer 类型值。如果 stringorblob 参数中的值不是有效的 PowerScript 数字或数据类型不兼容，那么 Integer()函数返回 0。如果 stringorblob 参数的值为 NULL，则 Integer()函数返回 NULL。 Long() 功能将其它类型的数据转换为 Long 类型的值。该函数有两种语法格式： 语法一、将两个无符号整数组合成一个长整数值； 语法二、将字符 串或 Blob 值转换成 Long 类

16、型的值。下面分别予以介绍： 语法一、将两个无符号整数组合成一个长整数值 语法 Long ( lowword, highword ) 参数 lowword： UnsignedInteger 类型，指定长整数中的低位值 highword： UnsignedInteger 类型，指定长整数中的高位值返回值 Long。函数执行成功时返回由低位值和高位值组合后的长整数值，发生错误时返回 -1。如果任何参数的值为 NULL，则 Long()函数返回 NULL。 语法二、将字符串或 Blob 值转换成 Long 类型的值 语法 Long ( stringorblob ) 参数 stringorblob： s

17、tring 类型变量或 Blob类型变量。 Blob 类型变量时，把该变量第一个值转换为 Long 类型的值，其余部分被忽略。 stringorblob 参数也可以是包含上述类型数据的 Any 类型变量返回值 Long。函数执行成功时返回相应的 Long 类型值。如果 stringorblob 参数中的值不是有效的 PowerScript 数字或数据类型不兼容，那么 Long()函数返回 0。如果 stringorblob 参数的值为 NULL，则 Long()函数返回 NULL。 Real() 功能将字符串或 Blob 值转换成 Real类型的值。 语法 Real ( stringorblo

18、b ) 参数 stringorblob： string 类型变量或 Blob类型变量。当该参数是 Blob 类型变量时，把该变量第一个值转换为 Real类型的值，其余部分被忽略。 stringorblob 参数也可以是包含上述类型数据的 Any 类型变量返回值 Real。函数执行成功时返回相应的 Real类型值。如果 stringorblob 参数中的值不是有效的 PowerScript 数字或数据类型不兼容，那么 Real()函 数返回 0。如果 stringorblob参数的值为 NULL,则 Real()函数返回 NULL。 Date()功能 将其它类型的数据转换为 Date 类型的数据

19、。该函数有三种语法格式： 语法一、将 DateTime 类型或第一个值是 DateTime 或 Date 的 Blob值转换成 Date 类型的值； 语法二、将其值是个有效日期的字符串转换成 Date 类型的值； 语法三、将三个整数组合成一个日期。下面分别予以介绍： 语法一、将 DateTime 类型或第一个值是 DateTime 或 Date 的 Blob值转换成 Date 类型的值 语法 Date ( datetime ) 参数 datetime： DateTime 类型的值或第一个值是 DateTime 或 Date 的 Blob 类型的值。当该参数是 Blob 类型变量时，把该变量第一

20、个值转换为 Date 类型的值，其余部分被忽略。 datetime 参数也可以是包含上述类型数据的 Any 类型变量返回值 Date。函数执行成功时返回相应的 Date 类型值。如果 datetime参数中的值不是有效的 PowerScript 日期或数据类型不兼容，那么 Date()函数返回 1900-01-01。如果datetime 参数的值为 NULL，则 Date()函数返回 NULL。 语法二、将其值是个有效日期的字符串转换成 Date 类型的值 语法 Date ( string ) 参数 string： string 类型，其值包括一个有效的以字符串形式表示的日期（比如 Janua

21、ry 1, 1998 或 12-31-99）， string 参数也可以是包含字符串类型数据的 Any 类型变量返回值 Date。函数执行成功时返回相应的 Date 类型值。如果 string 参数中的值不是有效的 PowerScript 日期或数据类型不兼容，那么 Date()函数返回 1900-01-01。如果 string参数的值为 NULL，则 Date()函数返回 NULL。 语法三、将三个表示年、月、日的整数组合成一个日期 语法 Date ( year, month, day ) 参数 year： integer 类型，指定日期中的年份，用四位数字表示，从 0 到 9999mont

22、h： integer 类型，指定日期中的月份，用一位或两位数字表示，从 1 到 12day： integer 类型，指定日期中的号数，用一位或两位数字表示，从 1 到 31 返回值 Date。函数执行成功时返回由 year、 month、 day 三个参数确定的日期。如果这三个参数中任何一个参 数使用了无效值（比如月份指定为 14），则 Date()函数返回 1900-01-01。如果任何参数的值为 NULL，则 Date()函数返回 NULL。 DateTime() 功能 将其它类型的数据转换为 DateTime 类型的数据。该函数有两种语法格式：语法一、把日期和时间值组合成 DateTim

23、e 类型的值；语法二、将 Blob 类型的值转换成 DateTime 类型的值。下面分别予以介绍： 语法一、把日期和时间值组合成 DateTime 类型的值 语法 DateTime ( date , time ) 参数 date： Date类型的日期值 time：可选参数， Time 类型的时间值，省略该参数时， PowerBuilder把时间设置为午夜（ 00:00:00.000000）。当指定该参数时，可以仅仅指定小时值返回值 DateTime。函数执行成功时返回日期和时间组合而成的 DateTime 类型的值。如果任何参数的值为 NULL，则 DateTime()函数返回 NULL。 语

24、法二、将 Blob 类型的值转换成 DateTime 类型的值 语法 DateTime ( blob ) 参数 blob： Blob 类型变量，把该变量第一个值转换为 DateTime 类型的 值，其余部分被忽略。 blob 参数也可以是包含 blob 类型数据的 Any 类型变量返回值 DateTime。函数执行成功时返回相应的 DateTime类型值。如果 blob 参数的值为 NULL,则 DateTime()函数返回 NULL。 IsDate() 功能检测指定的字符串是否包含有效的日期。 语法 IsDate ( datevalue ) 参数 datevalue： string类型，指定

25、要检测的字符串返回值 Boolean。如果 datevalue 包含了有效的日期，则 IsDate()函数返回 TRUE，否则返回 FALSE。如果 datevalue 参数的值为 NULL，则 IsDate()函数返回 NULL。 IsNull() 功能测试变量或表达式的值是否是 NULL。 语法 IsNull ( any ) 参数 any：要测试的变量或表达式返回值 Boolean：如果 any 的值为 NULL，函数返回 TRUE，否则函数返回 FALSE。 IsNumber() 功能测试字符串是否是有效的数值。 语法 IsNumber ( string ) 参数 string： str

26、ing 类型，要测试的字符串返回值 Boolean：如果 string 的值为有效的 PowerScript 数字，函数返回 TRUE，否则函数返回 FALSE。如果 string 参数的值为 NULL，则 IsNumber()函数返回 NULL。 IsTime() 功能测试字符串的值是否是有效的时间。 语法 IsTime ( timevalue ) 参数 timevalue： string 类型，要测试的字符串返回值 Boolean：如果 timevalue 的值为有效的时间，函数返回 TRUE，否则函数返回 FALSE。如果 timevalue 参数的值为 NULL，则 IsTime()函

27、数返回 NULL。 String() 功能按指定格 式将数据转换成字符串。 String()可以把 Date、 DateTime、数值类型、 Time、 String类型的数据转换成指定格式的字符串。 语法 String(data,format) 参数 data：指定要转换格式的数据，其数据类型可以是 Date、 DateTime、数值类型、 Time、 String，也可以是包含上述类型数据的 Any 类型变量 format：可选项， string 类型，其值指定数据格式。如果 data 参数的类型为 string，则必须指定 format 参数返回值 String。函数执行成功时返回以字符

28、串方 式表示的指定数据，如果 data 参数的数据类型与 format 参数指定的格式不匹配、 format 参数指定的格式无效、或 data 参数不是前面提到的适宜数据类型时， String()函数返回空字符串（ “）。 用法 : format 是个用掩码表示的字符串，对 data 参数为数值类型的情况来说，格式为：正数格式；负数格式；零的显示格式；空的显示格式除第一部分必须提供外，其它部分可以省略。数值型显示格式中使用两个掩码字符： #和 0，其中，使用 #代表 09 之间的任意数字， 0 代表每个零都要显示。另外，货币符号（ $或￥）、百分号（ %）、小数点（ .）、逗号（，）等字符也可

29、以出现在格式字符串中，但是，除小数点（ .）、逗号（，）能够出现在格式字符 #和 0 之间外，其它字符只能放置在格式串的前面或后面，例如， #,#$#是个错误的格式串，￥ #,#,#是个正确的格式串。省略 format 参数时， String()函数使用 PowerBuilder 缺省格式。注意，如果显示格式有多个部分，各部分之间的分号（；）不能省略。其它字符也可以出现在显示格式字符串中（只能放在格式串的开头和末尾），但它们没有特殊意义，系统只是照原样显示。例如，用显 示格式字符串 “收入 #”格式化数值 12 时，显示结果为 “收入 12”。对 data参数为字符串（ String）类型的情

30、况来说， format 参数的语法格式为：正常字符串格式；空值时格式在 “正常字符串格式 ”中， 代表字符串中的任意字符，除此之外的任何字符照原样显示，例如，如果定义了下面的格式：（ ） -则字符串 0166767593 显示为：（ 01） 6676-7593 对 data参数为日期（ Date）类型的情况来说， format 参数的语法格式为：正常日期格式；日期为空值时的格式日期格式中格式字符意义如下： d 棗开头不带 0 的日数（如 8） dd 棗开头带 0 的日数（如 08） ddd 棗星期的英文缩写（如 Mon、 Tue） dddd 棗星期的英文全称（如 Monday、 Tuesday

31、） m棗开头不带 0 的月份（如8） mm 棗开头带 0 的月份（如 08） mmm棗月份的英文缩写（如 Jan、 Feb） mmmm棗月份的英文全称（如 January、 February） yy 棗两位数字表示的年份（如 97） yyyy 棗四位数字表示的年份（如 1997）另外，还可以使用下面的关键字作为日期的显示格式： General Windows 系统中定义的短日期格式 LongDate Windows 系统中定义的长日期格式 ShortDate Windows 系统中定义的短日期格式对data 参数为时间（ Time）类型的情况来说，语法格式为：正常时间格式；时间为空值时的格式时

32、间格式中格式字符意义如下： h 开头不带 0 的小时（比如 6） hh 棗开头带 0 的小时（比如 06） m棗开头不带 0的分钟（比如 6） mm 棗开头带 0 的分钟（比如 06） s 棗开头不带 0 的秒（比如 6） ss 棗开头带 0 的秒（比如 06） f棗开头不带 0 的微秒，可以指定 16 个 f，每个 f代表一部分微秒 AM/PM 棗用 AM/PM 显示上、下午时间， 12 小时制 am/pm棗用 am/pm显示上、下午时间， 12 小时制 A/P 棗用 A/P 显示上、下午时间， 12 小时制 a/p 棗用 a/p 显示上、下午时间， 12 小时制另外，显示格式中还可以使用关

33、键字 Time，它表示按当前 Windows系统定义的格式显示时间。对 data 参数为日期时间（ DateTime）类型的情况来说，语法格式为：正常日期时间格式；日期时间为空值时的格式日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。 Time() 功能 把其它类型的数据转换为 Time 类型的值。该函数有三种语法格式：语法一、将 DateTime类型或第一个值是 DateTime 或 Time 的 Blob 值转换成 Time 类型的值；语法二、将其值是个有效时间的字符串转换成 Time 类型的值；语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值。下面分别予以介绍： 语法

34、一、将 DateTime 类型或第一个值是 DateTime 或 Time 的 Blob 值转换成 Time 类型的值 语法 Time ( datetime ) 参数 datetime： DateTime 类型的值或第一个值是 DateTime 或 Time 的 Blob 类型的值。当该参数是 Blob 类型变量时，把该变 量第一个值转换为 Time 类型的值，其余部分被忽略。 datetime参数也可以是包含上述类型数据的 Any 类型变量返回值 Time。函数执行成功时返回相应的 Time类型值。如果 datetime 参数中的值不是有效的 PowerScript 时间或数据类型不兼容，那

35、么 Time()函数返回 00:00:00.000000。如果 datetime 参数的值为 NULL，则 Time()函数返回 NULL。 语法二、将其值是个有效时间的字符串转换成 Time 类型的值 语法 Time ( string ) 参数 string： string 类型，其 值包括一个有效的以字符串形式表示的时间（比如 9am或 10:25），string 参数也可以是包含时间类型数据的 Any 类型变量返回值 Time。函数执行成功时返回相应的Time 类型值。如果 string 参数中的值不是有效的 PowerScript 时间或数据类型不兼容，那么 Time()函数返回 00

36、:00:00.000000。如果 string 参数的值为 NULL，则 Time()函数返回 NULL。 语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值 语法 Time ( hour, minute, second , microsecond ) 参数 hour： integer 类型，指定时间中的小时，从 0 到 23minute： integer 类型，指定时间中的分钟，从 0 到 59second： integer 类型，指定时间中的秒，从 0 到 59microsecond： integer类型，可选项，指定时间中的微秒，从 0 到 32767 返回值 Time。函数执行成功时返回由 hour、minute、 second、 microsecond 四个参数确定的时间。如果这四个参数中任何一个参数使用了无效值（比如小时指定为 44），则 Time()函数返回 NULL。 Beep() 功能响铃 n 次（ n 超过 10 时只响 10 次）。