PowerBuilder函数详解上.docx

PowerBuilder函数详解上.docx

《PowerBuilder函数详解上.docx》由会员分享，可在线阅读，更多相关《PowerBuilder函数详解上.docx（11页珍藏版）》请在冰点文库上搜索。

PowerBuilder函数详解上

PowerBuilder函数详解（上）

作者佚名    来源技术文章总汇    发布时间2005-07-13    浏览次数4016    字体大  中  小

内容摘要在这里把PowerBuilder各个版本的基本函数整理一下,奉献给大家,希望能在编程过程中起到帮助!

数组函数

∙LowerBound（）

LowerBound（）功能得到指定数组第n维的下界。

语法LowerBound（array{,n}）

参数array：

数组名n：

数值类型，可选项，指定要得到数组哪一维的下界。

缺省值为1返回值Long。

函数执行成功时返回array数组第n维的下界。

如果n的值超过了指定数组的最大维数，那么该函数返回-1。

如果任何参数的值为NULL，LowerBound（）函数返回NULL。

∙UpperBound（）

UpperBound（）功能得到指定数组第n维的上界。

语法UpperBound（array{,n}）

参数array：

数组名n：

数值类型，可选项，指定要得到数组哪一维的上界。

缺省值为1返回值Long。

函数执行成功时返回array数组第n维的上界。

如果n的值超过了指定数组的最大维数，那么该函数返回-1。

如果任何参数的值为NULL，UpperBound（）函数返回NULL。

　Blob（大二进制对象）函数

∙Blob（）

Blob（）功能将字符串转换成Blob类型数据。

语法Blob（text）

参数text：

string类型，指定要转换的数据返回值Blob。

函数执行成功时返回转换后的Blob类型数据；如果text参数的值为NULL，则Blob（）函数返回NULL。

∙BlobEdit（）

功能将任意类型的数据插入到Blob类型变量的指定位置。

语法BlobEdit（blobvariable,n,data）

参数blobvariable：

Blob类型的已初始化变量，将向该变量中插入数据n：

指定插入位置，有效值在1到4,294,967,295之间data：

要插入到Blob类型变量中的数据，其数据类型可以是任何有效的PowerBuilder数据类型返回值Unsignedlong。

函数执行成功时返回下次可以插入数据的位置；如果blobvariable变量中空间不够或任何参数的值为NULL，则BlobEdit（）函数返回NULL。

∙BlobMid（）

功能从Blob变量中提取出一段数据。

提取之后，原Blob变量内容不变。

语法BlobMid（data,n{,length}）

参数data：

Blob类型的数据n：

指定要提取数据的起始位置，有效值在1到4,294,967,295之间length：

可选项，指定要提取数据的长度，以字节为单位，有效值在1到4,294,967,295之间。

缺省时提取从指定位置n到末尾的所有数据返回值Blob。

函数执行成功时返回指定字节数的数据。

如果n的值大于data的字节数，函数返回空。

如果n与length的和超过了data数据的字节数，那么BlobMid（）函数返回剩下的数据，数据长度将小于参数length的值。

如果任何参数的值为NULL，则BlobMid（）函数返回NULL。

∙Len（）

功能得到Blob类型变量的数据长度，以字节为单位。

语法Len（blob）

参数blob：

Blob类型变量返回值Long。

函数执行成功时返回blob变量的长度，发生错误时返回-1。

如果任何参数的值为NULL，则Len（）函数返回NULL。

用法如果在说明Blob类型的变量时指定了变量长度，那么对该变量来说，Len（）函数得到的就是这个指定的长度。

如果在变量说明时未指定变量长度，那么PowerBuilder在赋值时调整长度，未赋值Blob类型变量的长度为0。

∙String（）

功能将Blob类型变量的值转换成字符串类型。

如果Blob类型变量的值不是文本型数据，String（）函数将其值解释成字符。

语法String（blob）

参数blob：

要对其值进行类型转换的Blob类型变量返回值String。

函数执行成功时返回转换后的数据，失败时返回空字符串（""）。

如果blob变量中包含的数据不是字符串类型的数据，那么String（）函数尽可能把数据解释为字符，并返回字符串类型数据。

如果blob参数的值为NULL，则String（）函数返回NULL。

数据类型检查与转换函数

∙String（）

功能按指定格式将数据转换成字符串。

String（）可以把Date、DateTime、数值类型、Time、String类型的数据转换成指定格式的字符串。

语法String（data,{format}）

参数data：

指定要转换格式的数据，其数据类型可以是Date、DateTime、数值类型、Time、String，也可以是包含上述类型数据的Any类型变量format：

可选项，string类型，其值指定数据格式。

如果data参数的类型为string，则必须指定format参数返回值String。

函数执行成功时返回以字符串方式表示的指定数据，如果data参数的数据类型与format参数指定的格式不匹配、format参数指定的格式无效、或data参数不是前面提到的适宜数据类型时，String（）函数返回空字符串（""）。

用法:

format是个用掩码表示的字符串，对data参数为数值类型的情况来说，格式为：

正数格式；负数格式；零的显示格式；空的显示格式除第一部分必须提供外，其它部分可以省略。

数值型显示格式中使用两个掩码字符：

#和0，其中，使用#代表0~9之间的任意数字，0代表每个零都要显示。

另外，货币符号（$或￥）、百分号（%）、小数点（.）、逗号（，）等字符也可以出现在格式字符串中，但是，除小数点（.）、逗号（，）能够出现在格式字符#和0之间外，其它字符只能放置在格式串的前面或后面，例如，###,###$###是个错误的格式串，￥###,###,###是个正确的格式串。

省略format参数时，String（）函数使用PowerBuilder缺省格式。

注意，如果显示格式有多个部分，各部分之间的分号（；）不能省略。

其它字符也可以出现在显示格式字符串中（只能放在格式串的开头和末尾），但它们没有特殊意义，系统只是照原样显示。

例如，用显示格式字符串“收入##”格式化数值12时，显示结果为“收入12”。

对data参数为字符串（String）类型的情况来说，format参数的语法格式为：

正常字符串格式；空值时格式在“正常字符串格式”中，@代表字符串中的任意字符，除此之外的任何字符照原样显示，例如，如果定义了下面的格式：

（@@）@@@@-@@@@则字符串0166767593显示为：

（01）6676-7593对data参数为日期（Date）类型的情况来说，format参数的语法格式为：

正常日期格式；日期为空值时的格式日期格式中格式字符意义如下：

d开头不带0的日数（如8）dd开头带0的日数（如08）ddd星期的英文缩写（如Mon、Tue）dddd星期的英文全称（如Monday、Tuesday）m开头不带0的月份（如8）mm开头带0的月份（如08）mmm月份的英文缩写（如Jan、Feb）mmmm月份的英文全称（如January、February）yy两位数字表示的年份（如97）yyyy四位数字表示的年份（如1997）另外，还可以使用下面的关键字作为日期的显示格式：

[General]Windows系统中定义的短日期格式[LongDate]Windows系统中定义的长日期格式[ShortDate]Windows系统中定义的短日期格式对data参数为时间（Time）类型的情况来说，语法格式为：

正常时间格式；时间为空值时的格式时间格式中格式字符意义如下：

h开头不带0的小时（比如6）hh开头带0的小时（比如06）m开头不带0的分钟（比如6）mm开头带0的分钟（比如06）s开头不带0的秒（比如6）ss开头带0的秒（比如06）f开头不带0的微秒，可以指定1~6个f，每个f代表一部分微秒AM/PM用AM/PM显示上、下午时间，12小时制am/pm用am/pm显示上、下午时间，12小时制A/P用A/P显示上、下午时间，12小时制a/p用a/p显示上、下午时间，12小时制另外，显示格式中还可以使用关键字[Time]，它表示按当前Windows系统定义的格式显示时间。

对data参数为日期时间（DateTime）类型的情况来说，语法格式为：

正常日期时间格式；日期时间为空值时的格式日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。

∙Time（）

功能把其它类型的数据转换为Time类型的值。

该函数有三种语法格式：

语法一、将DateTime类型或第一个值是DateTime或Time的Blob值转换成Time类型的值；语法二、将其值是个有效时间的字符串转换成Time类型的值；语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值。

下面分别予以介绍：

语法一、将DateTime类型或第一个值是DateTime或Time的Blob值转换成Time类型的值

语法Time（datetime）

参数datetime：

DateTime类型的值或第一个值是DateTime或Time的Blob类型的值。

当该参数是Blob类型变量时，把该变量第一个值转换为Time类型的值，其余部分被忽略。

datetime参数也可以是包含上述类型数据的Any类型变量返回值Time。

函数执行成功时返回相应的Time类型值。

如果datetime参数中的值不是有效的PowerScript时间或数据类型不兼容，那么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:

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。

数值计算函数

∙Abs（）

功能计算绝对值。

语法Abs（n）

参数n：

要得到绝对值的数值型变量或表达式返回值返回值的数据类型与n的数据类型相同，函数执行成功时返回n的绝对值。

如果参数n的值为NULL，Abs（）函数返回NULL。

∙Ceiling（）

功能返回大于n的最小整数。

语法Ceiling（n）

参数n：

数值型变量或表达式返回值返回值的数据类型与n的数据类型相同。

函数执行成功时返回大于n的最小整数。

如果参数n的值为NULL，Ceiling（）函数返回NULL。

∙Cos（）

功能计算余弦，其中参数以弧度为单位。

语法Cos（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（）函数返回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（）

功能计算n的常用对数（以10为底）。

语法LogTen（n）

参数n：

数值型变量或表达式，其值必须大于0返回值Double。

函数执行成功时返回n的常用对数。

如果n小于等于0，将导致运行错误。

如果参数n的值为NULL，LogTen（）函数返回NULL。

∙Max（）

功能求两个数中的最大值。

语法Max（x,y）

参数x：

数值型变量或表达式，参加比较的第一个数y：

数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回参数比较的两个数中更大者。

如果任何参数的值为NULL，Max（）函数返回NULL。

∙Min（）

功能求两个数中的最小值。

语法Min（x,y）

参数x：

数值型变量或表达式，参加比较的第一个数y：

数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回参数比较的两个数中较小者。

如果任何参数的值为NULL，Min（）函数返回NULL。

∙Mod（）

功能求余数。

语法Mod（x,y）

参数x：

数值型变量或表达式，被除数y：

数值型变量或表达式，除数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回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到32,767之间返回值与n的数据类型相同。

函数执行成功时返回1与n之间的一个伪随机数，包括1和n在内。

如果参数n的值为NULL，Rand（）函数返回NULL。

∙Randomize（）

功能初始化伪随机数发生器，这样让应用程序每次使用不同的伪随机数序列。

语法Randomize（n）

参数n：

数值型变量或表达式，指定伪随机数生成器使用的起始值，不同的起始值可以生成不同的伪随机数序列。

当n的值为0时，该函数把系统时钟作为伪随机数生成器的起始值，这样可以生成不可重复的伪随机数序列。

当n的值不为0时，可以产生不同的伪随机数序列，但是，如果两次使用相同的伪随机数生成器起始值，那么两次生成的伪随机数序列相同。

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：

数值型变量或表达式，指定要测试符号的值返回值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的平方根。

如果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截断到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Truncate（）函数返回NULL。

所谓截断就是舍弃指定位之后的数值。

 字符串操作函数

∙Fill（）

功能建立一个由指定字符串填充的指定长度的字符串。

语法Fill（chars,n）

参数chars：

string类型，指定用于重复填充的字符串n：

long类型，指定由该函数返回的字符串的长度返回值String。

函数执行成功时返回n个字符的字符串，该字符串以参数chars中的字符串重复填充而成。

如果参数chars中的字符个数多于n个，那么使用chars字符串的前n个字符填充函数返回的字符串；如果参数chars中的字符个数少于n个，那么使用chars字符串反复填充，直到返回的字符串长度达到n为止。

如果任何参数的值为NULL，Fill（）函数返回NULL。

∙Left（）

功能得到字符串左部指定个数的字符。

语法Left（string,n）

参数string：

string类型，指定要提取子串的字符串n：

long类型，指定子串长度返回值String。

函数执行成功时返回string字符串左边n个字符，发生错误时返回空字符串（""）。

如果任何参数的值为NULL，Left（）函数返回NULL。

如果n的值大于string字符串的长度，那么Left（）函数返回整个string字符串，但并不增加其它字符。

∙LeftTrim（）

功能返回指定字符串删除了左部空格后的字符串。

语法LeftTrim（string）

参数string：

string类型，指定要删除左部空格的字符串返回值String。

函数执行成功时返回删除了string字符串左部空格的字符串，发生错误时返回空字符串（""）。

如果任何参数的值为NULL，LeftTrim（）函数返回NULL。

∙Len（）

功能得到字符串的长度。

语法Len（string）

参数string：

string类型变量返回值Long。

函数执行成功时返回字符串的长度，发生错误时返回-1。

如果任何参数的值为NULL，则Len（）函数返回NULL。

∙Lower（）

功能将字符串中的大写字母转换为小写字母。

语法Lower（string）

参数string：

要将其中的大写字母转换为小写字母的字符串返回值String。

函数执行成功时返回将大写字母转换为小写字母后的字符串，发生错误时返回空字符串（""）。

如果string参数的值为NULL，Lower（）函数返回NULL。

∙Match（）

功能确定字符串中是否包含指定模式的字符。

语法Match（string,textpattern）

参数string：

string类型，指定要检查是否匹配指定模式的字符串textpattern：

string类型，指定文本匹配模式返回值Boolean：

如果字符串string与模式textpattern相匹配，则函数返回TRUE，否则返回FALSE。

如果指定的匹配模式无效或上述两个参数中的任何一个未曾赋值，那么Match（）函数返回FALSE。

如果任何参数的值为NULL，Match（）函数返回NULL。

用法textpattern参数的写法与正则表达式十分相似，它由元字符和普通字符组成。

每个元字符都有不同的匹配含义，普通字符则与其自身相匹配。

下面是匹配模式中使用的元字符及其意义：

^指示字符串的开始，例如，^asd表示以asd开头的字符串，字符串asdfgh与模式^asd匹配，而字符串basdfg与模式^asd不匹配。

$指示字符串的结束，例如，red$表示所有以red结束的字符串均与该模式匹配，而redo与模式red$不匹配。

.匹配任意单个字符，例如，^&&$匹配任何六个字符组成的字符串。

[]匹配括号中列出的字符，例如，^[ABC]$匹配由一个字符组成的字符串，其值只能是A或B或C。

-与方括号一起，指定匹配字符的范围，例如，^[A-Z]$只匹配那些由一个大写字母组成的字符串。

方括号里还可以使用^字符，表示匹配不在指定范围内的任何字符，例如，[^0-9]匹配除数字外的任何字符。

*，+，?

这些符号跟在一个字符后面表示该字符可以出现的次数。

星号（*）表示可以出现0次或任意次；加号（+）表示可以出现多次，但至少出现一次；问号（?

）表示出现0次或一次。

例如，A*匹配0个或多个A（没有A、A、AA、AAA、AAAA、**）；A+匹配1个或多个A（A、AA、AAA、AAAA、**）；A?

匹配空串或1个A。

斜杠（）是转义字符，它去掉特殊字符的特殊含义，比如，模式$匹配字符$，模式\匹配字符。

∙Mid（）

功能取字符串的子串。

语法Mid（string,start{,le