PowerBuilder函数大全

2024年3月17日发(作者：健身标语)

***************************************************************************************************

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数据类型返回值Unsigned long。函数执行成功时返回下次可以插入数据的

位置；如果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参数为数值类型的情况来说，格式为：正数格式；负数