PB函数中文详解.docx
- 文档编号:12467547
- 上传时间:2023-04-19
- 格式:DOCX
- 页数:63
- 大小:46.33KB
PB函数中文详解.docx
《PB函数中文详解.docx》由会员分享,可在线阅读,更多相关《PB函数中文详解.docx(63页珍藏版)》请在冰豆网上搜索。
PB函数中文详解
PB函数中文详解
数组函数
∙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。
数据类型检查与转换函数
∙Asc()
功能得到字符串第一个字符的ASCII码整数值。
语法Asc(string)
参数string:
要得到第一个字符ASCII值的字符串返回值Integer。
函数执行成功时返回string参数第一个字符的ASCII值,如果string参数的值为NULL,则Asc()函数返回NULL。
∙Char()
功能将字符串的第一个字符、Blob变量的第一个值、或一个整数转换成字符。
语法Char(n)
参数n:
字符串、Blob变量或整数,也可以是包含上述类型数据的Any类型变量返回值Char。
返回参数n的第一个字符。
如果n参数的值为NULL,则Char()函数返回NULL。
∙Dec()
功能将字符串或Blob值转换成Decimal类型的值。
语法Dec(stringorblob)
参数stringorblob:
string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Decimal类型的值,其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Decimal。
函数执行成功时返回相应的Decimal类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Dec()函数返回0。
如果stringorblob参数的值为NULL,则Dec()函数返回NULL。
∙Double()
功能将字符串或Blob值转换成Double类型的值。
语法Double(stringorblob)
参数stringorblob:
string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Double类型的值,其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Double。
函数执行成功时返回相应的Double类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Double()函数返回0。
如果stringorblob参数的值为NULL,则Double()函数返回NULL。
∙Integer()
功能将字符串或Blob值转换成Integer类型的值。
语法Integer(stringorblob)
参数stringorblob:
string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Integer类型的值,其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Integer。
函数执行成功时返回相应的Integer类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Integer()函数返回0。
如果stringorblob参数的值为NULL,则Integer()函数返回NULL。
∙Long()
功能将其它类型的数据转换为Long类型的值。
该函数有两种语法格式:
语法一、将两个无符号整数组合成一个长整数值;
语法二、将字符串或Blob值转换成Long类型的值。
下面分别予以介绍:
语法一、将两个无符号整数组合成一个长整数值
语法Long(lowword,highword)
参数lowword:
UnsignedInteger类型,指定长整数中的低位值highword:
UnsignedInteger类型,指定长整数中的高位值返回值Long。
函数执行成功时返回由低位值和高位值组合后的长整数值,发生错误时返回-1。
如果任何参数的值为NULL,则Long()函数返回NULL。
语法二、将字符串或Blob值转换成Long类型的值
语法Long(stringorblob)
参数stringorblob:
string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Long类型的值,其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Long。
函数执行成功时返回相应的Long类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Long()函数返回0。
如果stringorblob参数的值为NULL,则Long()函数返回NULL。
∙Real()
功能将字符串或Blob值转换成Real类型的值。
语法Real(stringorblob)
参数stringorblob:
string类型变量或Blob类型变量。
当该参数是Blob类型变量时,把该变量第一个值转换为Real类型的值,其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Real。
函数执行成功时返回相应的Real类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Real()函数返回0。
如果stringorblob参数的值为NULL,则Real()函数返回NULL。
∙Date()功能将其它类型的数据转换为Date类型的数据。
该函数有三种语法格式:
语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值;
语法二、将其值是个有效日期的字符串转换成Date类型的值;
语法三、将三个整数组合成一个日期。
下面分别予以介绍:
语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值
语法Date(datetime)
参数datetime:
DateTime类型的值或第一个值是DateTime或Date的Blob类型的值。
当该参数是Blob类型变量时,把该变量第一个值转换为Date类型的值,其余部分被忽略。
datetime参数也可以是包含上述类型数据的Any类型变量返回值Date。
函数执行成功时返回相应的Date类型值。
如果datetime参数中的值不是有效的PowerScript日期或数据类型不兼容,那么Date()函数返回1900-01-01。
如果datetime参数的值为NULL,则Date()函数返回NULL。
语法二、将其值是个有效日期的字符串转换成Date类型的值
语法Date(string)
参数string:
string类型,其值包括一个有效的以字符串形式表示的日期(比如January1,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到9999month:
integer类型,指定日期中的月份,用一位或两位数字表示,从1到12day:
integer类型,指定日期中的号数,用一位或两位数字表示,从1到31返回值Date。
函数执行成功时返回由year、month、day三个参数确定的日期。
如果这三个参数中任何一个参数使用了无效值(比如月份指定为14),则Date()函数返回1900-01-01。
如果任何参数的值为NULL,则Date()函数返回NULL。
∙DateTime()
功能将其它类型的数据转换为DateTime类型的数据。
该函数有两种语法格式:
语法一、把日期和时间值组合成DateTime类型的值;语法二、将Blob类型的值转换成DateTime类型的值。
下面分别予以介绍:
语法一、把日期和时间值组合成DateTime类型的值
语法DateTime(date{,time})
参数date:
Date类型的日期值time:
可选参数,Time类型的时间值,省略该参数时,PowerBuilder把时间设置为午夜(00:
00:
00.000000)。
当指定该参数时,可以仅仅指定小时值返回值DateTime。
函数执行成功时返回日期和时间组合而成的DateTime类型的值。
如果任何参数的值为NULL,则DateTime()函数返回NULL。
语法二、将Blob类型的值转换成DateTime类型的值
语法DateTime(blob)
参数blob:
Blob类型变量,把该变量第一个值转换为DateTime类型的值,其余部分被忽略。
blob参数也可以是包含blob类型数据的Any类型变量返回值DateTime。
函数执行成功时返回相应的DateTime类型值。
如果blob参数的值为NULL,则DateTime()函数返回NULL。
∙IsDate()
功能检测指定的字符串是否包含有效的日期。
语法IsDate(datevalue)
参数datevalue:
string类型,指定要检测的字符串返回值Boolean。
如果datevalue包含了有效的日期,则IsDate()函数返回TRUE,否则返回FALSE。
如果datevalue参数的值为NULL,则IsDate()函数返回NULL。
∙IsNull()
功能测试变量或表达式的值是否是NULL。
语法IsNull(any)
参数any:
要测试的变量或表达式返回值Boolean:
如果any的值为NULL,函数返回TRUE,否则函数返回FALSE。
∙IsNumber()
功能测试字符串是否是有效的数值。
语法IsNumber(string)
参数string:
string类型,要测试的字符串返回值Boolean:
如果string的值为有效的PowerScript数字,函数返回TRUE,否则函数返回FALSE。
如果string参数的值为NULL,则IsNumber()函数返回NULL。
∙IsTime()
功能测试字符串的值是否是有效的时间。
语法IsTime(timevalue)
参数timevalue:
string类型,要测试的字符串返回值Boolean:
如果timevalue的值为有效的时间,函数返回TRUE,否则函数返回FALSE。
如果timevalue参数的值为NULL,则IsTime()函数返回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的常用对数
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- PB 函数 中文 详解