PowerBuilder函数详解

PowerBuilder函数详解LowerBound()功能：得到指定数组第n维的下界语法：LowerBound(array{,n})参数array：数组名n：数值类型，可选项，指定要得到数组哪一维的下界。缺省值为1返回值Long。函数执行成功时返回array数组第n维的下界。如果n的值超过了指定数组的最大维数，那么该函数返回-1。如果任何参数的值为NULL，LowerBound()函数返回NULL。UpperBound()功能：得到指定数组第n维的上界。语法：UpperBound(array{,n})参数array：数组名n：数值类型，可选项，指定要得到数组哪一维的上界。缺省值为1返回值Long。函数执行成功时返回array数组第n维的上界。如果n的值超过了指定数组的最大维数，那么该函数返回-1。如果任何参数的值为NULL，UpperBound()函数返回NULL。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显示为：[phone]对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)：计算n的阶乘。n：数值型变量或表达式。返回值Double。成功时返回n的阶乘。如果参数n的值为NULL，函数返回NULL。Int(n)得到小于等于n的最大整数。n：数值型变量或表达式。返回值Integer。成功时返回小于等于n的最大整数。如果n的值太小或太大，超过了整数的表示范围，则函数返回0。如果参数n的值为NULL，函数返回NULL。Log()功能计算n的自然对数。语法Log(