PB常用函数详解

主要展示几个常用的函数，大家可以了解下

数值计算函数

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。

Max()
功能求两个数中的最大值。
语法Max ( x, y )
参数x：数值型变量或表达式，参加比较的第一个数y ：数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中更大者。如果任何参数的值为NULL，Max()函数返回NULL。

为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中更大者。如果任何参数的值为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。

Round()
功能将x四舍五入到n位。
语法Round ( x, n )参数x：要四舍五入的数值型数据n：整数类型，指定从哪个小数位上四舍五入x。有效值在0到18之间返回值Decimal。函数执行成功时返回将x四舍五入到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Round()函数返回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。极少使用该函数的返回值。

Sign()
功能确定n是整数、负数还是零。
语法Sign ( n )
参数n：数值型变量或表达式，指定要测试符号的值返回值Integer。当n大于0时返回1；当n小于0时返回-1；当n等于0时返回0。如果参数n的值为NULL，Sign()函数返回NULL。

日期、时间函数

Day()/Month()/Year()
功能得到日期型数据中的号数(1到31之间的整数值)。
语法Day ( date )
参数date：要得到号数的日期值返回值 Integer。函数执行成功时返回号数(1到31之间的整数值)。如果date参数的值为NULL，则Day()函数返回NULL。

DayName()
功能得到指定日期是一周中的星期几(例如，Sunday, Monday…)。
语法DayName ( date )
参数date：date类型值或变量返回值String。函数执行成功时返回指定日期的星期表示(例如，Sunday, Monday…)。如果date参数的值为NULL，则DayName()函数返回NULL。

DayNumber()
功能得到日期型数据是一星期中的第几天(用1到7之间的整数表示，星期天为1，星期一为2，…)。
语法DayNumber ( date )
参数date：date类型值或变量返回值Integer。函数执行成功时返回指定日期是一星期中的第几天(用1~7表示，星期天为1，星期一为2，…)。如果date参数的值为NULL，则DayNumber()函数返回NULL。

DaysAfter()
功能得到两个日期间的天数。
语法DaysAfter ( date1, date2 )
参数date1：date类型，指定起始日期date2：date类型，指定终止日期返回值Long。函数执行成功时得到两个日期之间的天数。如果date2的日期在date1的前面，那么DaysAfter()函数返回负值。如果任何参数的值为NULL，则DaysAfter()函数返回NULL。

Hour()/Minute()/Second()
功能得到时间值中的小时/分钟/秒，采用24小时制。
语法Hour ( time )
参数time：time类型的值返回值Integer。函数执行成功时得到time参数中的小时（00到23之间）。如果time参数的值为NULL，则Hour()函数返回NULL。

Now()
功能得到客户机的当前系统时间，返回值为Time类型。
语法Now()返回值Time。该函数返回客户机的当前系统时间。

Today()
功能得到当前系统日期，在某些情况下，同时得到当前系统时间。
语法Today()返回值Date。该函数返回当前系统日期。用法单独调用Today()函数时，该函数总是返回当前系统日期，但是，虽然Today()函数的返回值类型为Date，在该函数用做某些函数的参数、而该参数要求DateTime类型的值时，Today()函数也能够在返回当前系统日期的同时返回当前系统时间。再如，Today()函数作为数据窗口控件SetItem()函数的参数，该函数参数中指定的数据窗口列的数据类型为DateTime，那么当前系统日期和时间将同时设置到数据窗口指定项中。

字符串操作函数
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参数的写法与正则表达式十分相似，它由元字符和普通字符组成。每个元字符都有不同的匹配含义，普通字符则与其自身相匹配。

Mid()
功能取字符串的子串。
语法Mid ( string, start {, length } )
参数string：string类型，指定要从中提取子串的字符串start：long类型，指定子串第一个字符在string字符串中的位置，第一个位置为1length：long类型，可选项，指定子串的长度返回值String。函数执行成功时返回string字符串中从start位置开始、长度为length的子串。如果start参数的值大于string中字符个数，那么Mid()函数返回空字符串。如果省略了length参数或length参数的值大于从start开始、string字符串中余下字符的长度，那么Mid()函数返回所有余下的字符。如果任何参数的值为NULL，Mid()函数返回NULL。

Pos()
功能在一个字符串中查找所包含的另一个字符串的起始位置。
语法Pos ( string1, string2 {, start } )
参数string1：string类型，指定要从中查找子串string2的字符串string2：string类型，指定要在string1中查找的字符串start：long类型，可选项，指定从string1的第几个字符开始查找。缺省值为1返回值Long。函数执行成功时返回在start位置后string2在string1中第一次出现的起始位置。如果在string1中按指定要求未找到string2、或start的值超过了string1的长度，那么Pos()函数返回0。如果任何参数的值为NULL，Pos()函数返回NULL。
用法Pos()函数在字符串查找时区分大小写，因此，“aa"不匹配"AA”。

Replace()
功能将一个字符串中指定个数的字符串替换为另一个字符串。
语法Replace ( string1, start, n, string2 )
参数string1：string类型，指定要使用string2替换其中一部分内容的字符串start：long类型，指定要从哪个字符位置开始替换字符串，字符串中第一个字符的位置为1n：long类型，指定要替换多少个字符string2：string类型，指定用哪个字符串替换string1的部分字符返回值String。函数执行成功时返回替换后的字符串，发生错误时返回空字符串（""）。如果任何参数的值为NULL，Replace()函数返回NULL。用法如果start参数指定的位置超过了string1的长度，那么Replace()函数把将string2拼接到string1的后面形成的字符串返回。如果n的值为0，那么Replace()函数把string2插入到string1指定位置后形成的字符串返回。

Right()
功能从字符串右端取指定个数字符。
语法Right ( string, n )
参数string：string类型，指定要提取子串的字符串n：long类型，指定子串长度返回值String。函数执行成功时返回string字符串右边n个字符，发生错误时返回空字符串（""）。如果任何参数的值为NULL，Right()函数返回NULL。如果n的值大于string字符串的长度，那么Right()函数返回整个string字符串，但并不增加其它字符。

RightTrim()
功能删除字符串尾部空格。
语法RightTrim ( string )
参数string：string类型，指定要删除右部空格的字符串返回值String。函数执行成功时返回删除了string字符串右部空格的字符串，发生错误时返回空字符串（""）。如果任何参数的值为NULL，RightTrim()函数返回NULL。

Space()
功能生成一个由空格组成的指定字符个数的字符串。
语法Space ( n )
参数n：long类型，指定要填充的空格个数，也就是填充后返回的字符串的长度返回值String。函数执行成功时返回由n个空格组成的字符串，发生错误时返回空字符串。如果参数n的值为NULL，Space()函数返回NULL。

Trim()
功能删除字符串首部和尾部的空格。
语法Trim ( string )
参数string：string类型，指定要删除首部和尾部空格的字符串返回值String。函数执行成功时返回删除了string字符串首部和尾部空格的字符串，发生错误时返回空字符串（""）。如果任何参数的值为NULL，Trim()函数返回NULL。

Upper()
功能将字符串中的小写字母转换为大写字母。
语法Upper( string )
参数string：要将其中的小写字母转换为大写字母的字符串返回值String。函数执行成功时返回将小写字母转换为大写字母后的字符串，发生错误时返回空字符串（""）。如果string参数的值为NULL，Upper()函数返回NULL。

小操作函数
RGB()
功能将代表红、绿、蓝三原色的三个整数组合成一个表示颜色的长整数。
语法RGB ( red, green, blue )
参数red：integer类型，指定颜色中的红色分量强度，有效值在0到255之间green：integer类型，指定颜色中的绿色分量强度，有效值在0到255之间blue：integer类型，指定颜色中的蓝色分量强度，有效值在0到255之间返回值Long。函数执行成功时返回由指定分量确定的颜色，用长整数表示。发生错误时返回-1。如果任何参数的值为NULL，RGB()函数返回NULL。
用法RGB()函数使用下述公式计算表示颜色的长整数：65536 * Blue+ 256 * Green+ Red其中，Blue代表蓝色分量，Green代表绿色分量，Red代表红色分量。各分量中，数值越小，亮度越低，数值越大，亮度越高。例如，RGB ( 0, 0, 0 )为黑色（亮度最低），RGB ( 255, 255,255 )为白色（亮度最高）。

SetNull()
功能将指定变量的值设置为NULL。这里的变量可以是除数组、结构、自动实例化对象之外的任何数据类型。
语法SetNull ( anyvariable )
参数anyvariable：要将其值设置为NULL的变量返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，SetNull()函数返回NULL。用法PowerBuilder应用程序在说明变量时，并不自动地将其初值设置为NULL，而是根据类型的不同而设置不同的初值，比如，数值类型的变量自动初始化为0，字符串型变量自动初始化为空字符串（""）。因此，如果需要将某个变量的值设置为NULL，就需要使用SetNull()函数来完成任务了。一般来说，NULL值往往应用在数据库值未确定的列上。

SetPointer()
功能设置鼠标指针。
语法SetPointer ( type )
参数type：Pointer枚举类型，指明要设置为哪种鼠标指针返回值Pointer。返回更换前的鼠标指针，以便于应用程序恢复原有指针。如果参数type的值为NULL，SetPointer()函数返回NULL。用法type参数的可能取值为：Arrow!、Cross!、Beam!、HourGlass!、SizeNS!、SizeNESW!、SizeWE!、SizeNWSE!、UpArrow!。

MessageBox()
功能显示一个消息对话框。
语法MessageBox(title,text{,icon{,button{,default}}})
参数title：string类型，指定消息对话框的标题text：指定消息对话框中显示的消息，该参数可以是数值数据类型、字符串或boolean值icon：Icon枚举类型，可选项，指定要在该对话框左侧显示的图标button：Button枚举类型，可选项，指定显示在该对话框底部的按钮default：数值型，可选项，指定作为缺省按钮的按钮编号，按钮编号自左向右依次计数，缺省值为1，如果该参数指定的编号超过了显示的按钮个数，那么MessageBox()函数将使用缺省值返回值Integer。函数执行成功时返回用户选择的按钮编号（例如1、2、3等），发生错误时返回-1。如果任何参数的值为NULL，MessageBox()函数返回NULL。
用法当你的应用程序需要显示一段简短信息（比如显示出错、警告等信息）时，没有必要自己从头创建窗口、安排控件，使用MessageBox()函数既简单又方便。用户只有响应该窗口后，程序才能继续运行下去。MessageBox()函数的icon参数指定显示在窗口中的图标，它是枚举类型，可能取值为： 取值 图标Information! StopSign! Exclamation! Question! None! 无图标其中Information!是Icon参数的缺省值。Button参数指定在窗口中显示哪些按钮，有效取值为：取值中文Windows 95下显示OK!“确定”按钮OKCancel!“确定”、“取消”按钮YesNo!“是”、“否”按钮 YesNoCancel!“是”、“否”、“取消”按钮RetryCancel!“重试”、“取消”按钮AbortRetryIgnore!“终止”、“重试”、“忽略”按钮