PB函数大全选读.doc

一、数组函数 1、LowerBound() 功 能：得到指定数组第n维的下界。 语 法：LowerBound ( array {, n } ) 参 数：array：数组名。 n：数值类型，可选项，指定要得到数组哪一维的下界。缺省值为1。 返回值：Long。函数执行成功时返回array数组第n维的下界。如果n的值超过了指定数组的最大维数，那么该函数返回-1。如果任何参数的值为NULL，LowerBound()函数返回NULL。 示 例：integer a[5], b[2,5] LowerBound(a) // Returns 1 LowerBound(a, 1) // Returns 1 LowerBound(a, 2) // Returns -1, a has only 1 dim LowerBound(b, 2) // Returns 1 integer c[ ] LowerBound(c) // Returns 1 c[50] = 900 LowerBound(c) // Returns 1 integer d[-10 to 50] LowerBound(d) // Returns - 10 2、UpperBound() 功 能：得到指定数组第n维的上界。 语 法：UpperBound( array {, n } ) 参 数：array：数组名。 n：数值类型，可选项，指定要得到数组哪一维的上界。缺省值为1。 返回值：Long。函数执行成功时返回array数组第n维的上界。如果n的值超过了指定数组的最大维数，那么该函数返回-1。如果任何参数的值为NULL，UpperBound()函数返回NULL。 示 例：integer a[5], b[2,5] LowerBound(a) // Returns 1 LowerBound(a, 1) // Returns 1 LowerBound(a, 2) // Returns -1, a has only 1 dim LowerBound(b, 2) // Returns 1 integer c[ ] LowerBound(c) // Returns 1 c[50] = 900 LowerBound(c) // Returns 1 integer d[-10 to 50] LowerBound(d) // Returns - 10 二、Blob（大二进制对象）函数 Blob函数得到Blob数据类型的信息、完成数据类型转换以及操作Blob类型数据。 1、Blob() 功 能：将字符串转换成Blob类型数据。 语 法：Blob ( text ) 参 数：text： string类型，指定要转换的数据。 返回值：Blob。函数执行成功时返回转换后的Blob类型数据；如果text参数的值为NULL，则Blob()函数返回NULL。 示 例：Blob B B = Blob(“北京”) 2、BlobEdit() 功 能：将任意类型的数据插入到Blob类型变量的指定位置。 语 法：BlobEdit ( blobvariable, n, data ) 参 数：blobvariable：Blob类型的已初始化变量，将向该变量中插入数据。 n：指定插入位置，有效值在1到4,294,967,295之间。 data：要插入到Blob类型变量中的数据，其数据类型可以是任何有效的PowerBuilder数据类型。 返回值：Unsigned long。函数执行成功时返回下次可以插入数据的位置；如果blobvariable变量中空间不够或任何参数的值为NULL，则BlobEdit()函数返回NULL。 示 例：下面的代码把一幅位图的数据复制到Blob类型变量emp_photo的起始位置，并把下次数据复制位置保存到变量nbr中，之后将当天的日期复制到emp_photo变量中位图数据的后面。 blob{1000} emp_photo blob temp date pic_date ulong nbr ... // Read BMP file containing employee picture ... // into temp using FileOpen and FileRead. pic_date = Today() nbr = BlobEdit(emp_photo, 1, temp) BlobEdit(emp_photo, nbr, pic_date) UPDATEBLOB Emp