PB函数大全（超全，解析很全面）

       这几天在pb花的时间比较长，用一个新的ide，一个新的语言，在短时间内去开发一个MIS，也是比较有难度的一件事儿。最主要的是熟悉语法格式和各种常用函数，再结合以前所学的编程语言，来快速消化并掌握它。

       工欲善其事，必先利其器。所以熟悉了语法格式后，常用函数则需要有个大概了了解，方便用时来查。下面是我收集的常用函数，比较多，希望对大家有用。

• 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的常用对数。如果n小于等于0，将导致运行错误。如果参数n的值为NULL，LogTen()函数返回NULL。
• Max()
  功能求两个数中的最大值。
  语法Max ( x, y )
  参数x：数值型变量或表达式，参加比较的第一个数y ：数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中更大者。如果任何参数的值为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。
• Pi()
  功能计算n与Pi(3.14159265358979323…)的乘积。
  语法Pi ( n )
  参数n：数值型变量或表达式返回值Double。函数执行成功时返回n与Pi(3.14159265358979323…)的乘积。发生错误时返回-1。如果参数n的值为NULL，Pi()函数返回NULL。
• Rand()
  功能得到1与n之间的一个伪随机数。
  语法Rand ( n )
  参数n：数值型变量或表达式，指定要产生的伪随机数的上界。有效值在1到32,767之间返回值与n的数据类型相同。函数执行成功时返回1与n之间的一个伪随机数，包括1和n在内。如果参数n的值为NULL，Rand()函数返回NULL。

• Truncate()
  功能截断数值到指定的小数位。
  语法Truncate ( x, n )
  参数x：要截断的数值型数据n：整数类型，指定从哪个小数位上截断x。有效值在0到18之间返回值Decimal。函数执行成功时返回将x截断到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Truncate()函数返回NULL。所谓截断就是舍弃指定位之后的数值。 　

• 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。

• UnitsToPixels()
  功能将PowerBuilder单位（PBU）转换为像素。
  语法UnitsToPixels ( units, type )
  参数units：integer类型，指定要转换为像素的PowerBuilder单位（PBU）数type：ConvertType枚举类型，指定按哪个方向进行转换。有效取值为：XUnitsToPixels! – 按水平方向转换PBU；YUnitsToPixels! – 按垂直方向转换PBU返回值Integer。函数执行成功时返回units参数指定PBU数按指定方向转换成的像素数，发生错误时返回-1。如果任何参数的值为NULL，UnitsToPixels()函数返回NULL。用法窗口中水平方向和垂直方向相同的像素数表示的距离并不相同。如果你使用水平方向和垂直方向相同的像素数绘制一个方框，那么你会看到，该方框不是正方形而是个矩形，而使用PBU计量的相同单位数将绘出正方形。因此，在进行单位转换时，需要指明按那么方向进行转换。

• 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。

• Yield()
  功能将控制权转移给其它图形对象，包括非PowerBuilder对象。该函数检测消息队列，如果有消息，就把消息取出。利用该函数可以在执行耗时较长的操作时把控制权转让给其它应用。
  语法Yield()
  返回值Boolean。如果在消息队列中提取到了消息，那么函数返回TRUE，否则返回FALSE。用法正常情况下，PowerBuilder应用程序在执行一段代码（比如函数或事件处理程序）的过程中不响应用户的操作。对耗时短暂的代码段来说，这种处理方式没有什么不妥的地方，但是，如果某个代码段的执行耗时较长，应用程序又希望为用户提供更多的控制权，那么需要在这段代码中插入Yield()函数，让用户能够进行其它操作，特别在循环执行的代码中更应该如此。应用程序执行Yield()函数后，如果发现消息队列中存在消息，它将允许对象处理这些消息，处理之后，继续Yield()函数后面代码的执行。因此，代码中插入Yield()函数将降低应用程序的运行效率。

• OpenWithParm()
  功能带参数打开窗口，与打开窗口的Open()函数相似，OpenWithParm()有两种语法格式：
  语法一、带参数打开编程时已知数据类型的窗口对象；
  语法二、带参数打开程序运行后才能确定数据类型的窗口对象。下面分别予以介绍：
  语法一、带参数打开编程时已知数据类型的窗口对象
  语法OpenWithParm(windowvar,parameter{,parent})
  参数windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectparent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。
  用法消息对象Message有三个属性用于存储OpenWithParm()函数传递给打开窗口的数据。根据parameter参数数据类型的不同，该参数的值保存在Message对象的不同属性中。
  语法二、带参数打开程序运行后才能确定数据类型的窗口对象
  语法OpenWithParm(windowvar,parameter,windowtype{,parent})
  参数windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectwindowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。

• StopHotLink()
  功能关闭与DDE服务器应用的热连接。
  语法StopHotLink ( location, applname, topic )
  参数location：string类型，指明要终止DDE服务器哪一部分的热连接。位置的表达方式由具体的DDE服务器决定applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要终止热连接的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1连接未曾启动-2请求被拒绝-3不能终止服务器如果任何参数的值为NULL，StopHotLink()函数返回NULL。 　

• Timer()
  功能 在指定的时间间隔内反复触发指定窗口的定时器事件。
  语法Timer ( interval {, windowname } )
  参数interval：指定两次触发Timer事件之间的时间间隔，有效值在0到65之间。如果该参数的值指定为0，那么关闭定时器，不再触发指定窗口的Timer事件windowname：窗口名，指定时间间隔到时要触发哪个窗口的Timer事件。省略该参数时，触发当前窗口的Timer事件返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Timer()函数返回NULL。用法使用Timer()函数可以周期性地触发指定窗口的Timer事件，这样，每当时间间隔过去时，应用程序都可以完成一些周期性的工作，比如绘制简单动画等。将Timer()的interval参数设置为非0值时启动定时器并开始计时；将该函数的interval参数设置为0时关闭定时器，终止计时任务。需要注意的是，在Microsoft Windows系统中，该函数能够计时的最小时间间隔为0.055秒（约1/18秒），如果把interval参数的值设置小于0.055，那么该定时器将每隔0.055秒触发一次窗口的Timer事件。Microsoft Windows 3.x最多只支持系统中同时启动16个定时器。

• Year()
  功能得到日期值中的年度(有效取值1000到3000)。
  语法Year(date)
  参数date：date类型的值返回值Integer。函数执行成功时得到date参数中的年份（采用四位数字），发生错误时返回1900，如果date参数的值为NULL，则Year()函数返回NULL。用法当应用程序把有两位数字表示年份的字符串转换成日期时，PowerBuilder根据下述规则选择世纪：如果年份值在00到49之间，PowerBuilder将年份中的世纪（前两位数字）当作20；如果年份值在50到99之间，PowerBuilder将年份中的世纪（前两位数字）当作19。比如，字符串”20-10-25″被PowerBuilder转换为2020-10-25；字符串”98-10-25″被PowerBuilder转换为1998-10-25。因此，如果应用程序中需要指定1950年之前的日期，应该使用四位数字表示年份，以避免引起歧义。PowerBuilder能够处理的年份从1000到3000之间。 　

• GetFileSaveName()
  功能显示保存文件对话框，让用户选择要保存到的文件。
  语法GetFileSaveName(title,pathname,filename{,extension{,filter}})
  参数title：string类型，指定对话框的标题pathname：string类型变量，用于保存该对话框返回的文件路径及文件名filename：string类型变量，用于保存该对话框返回的文件名extension：string类型，可选项，使用1到3个字符指定缺省的扩展文件名filter：string类型，可选项，其值为文件名掩码，指定显示在该对话框的列表框中供用户选择的文件名满足的条件（比如*.*，*.TXT，*.EXE等）返回值Integer。函数执行成功时返回1；当用户单击了对话框上的“Cancel”按钮时函数返回0；发生错误时返回-1。如果任何参数的值为NULL，那么GetFileSaveName()函数返回NULL。
  用法filter参数的格式为：description,*. ext缺省值为：”All Files (*.*),*.*”其中，description说明扩展名的意义，比如“所有文件”、“文本文件”等。你可以根据需要指定在打开文件对话框中显示的文件名类型。当需要指定多种文件类型时，各类型之间使用逗号分隔，例如：”PIF 文件, *.PIF, 批处理文件, *.BAT”需要注意的是，该函数只是得到一个文件名，而并没有打开文件，需要打开文件时，依然需要使用FileOpen()函数。

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

• StopServerDDE()
  功能停止当前应用的DDE服务器功能。执行该函数后，发给该应用的任何DDE客户应用请求都将失败。
  语法StopServerDDE ( { windowname, } applname, topic )
  参数windowname：可选项，指定要关闭服务器功能的服务器窗口名，缺省值为当前窗口，如果当前应用有多个服务器窗口，那么必须指定该参数applname：当前应用的DDE名称topic：string类型，应该与StartServerDDE()中对应参数相同返回值Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用未曾作为DDE服务器启动。如果任何参数的值为NULL，StopServerDDE()函数返回NULL。

• ToUnicode()
  功能将ANSI字符转换成Unicode字符。
  语法ToUnicode( blob)
  参数blob：要进行转换的ANSI编码的blob类型数据返回值String。函数执行成功时返回指定字符串对应的Unicode编码的字符串，发生错误时返回空字符串。 　

• LibraryImport()
  功能将以语法格式表示的数据窗口对象装入指定的应用库中。
  语法LibraryImport(libraryname,objectname,objecttype,syntax,errors{,comments } )
  参数libraryname：string类型，指定要移入对象的应用库的名称，如果名称中未指定路径，那么该函数根据操作系统标准的文件搜索路径查找指定文件objectname：string类型，指定要移入的数据窗口对象的名称 objecttype：LibImportType枚举类型，指定要移入对象的类型，目前该函数只支持ImportDataWindow!，表示只能向应用库中移入数据窗口对象syntax：string类型，指定要移入数据窗口对象的语法errors：string类型变量，用于在发生错误时保存出错信息comments：string类型，可选项，用于指定移入对象的注解返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，LibraryImport()函数返回NULL。
  用法当应用程序在运行过程中动态创建数据窗口对象后，可以使用LibraryImport()函数把动态数据窗口对象的定义保存到应用库中，以后就可以直接使用该对象了。

• UpperBound()
  UpperBound()功能得到指定数组第n维的上界。
  语法UpperBound( array {, n } )
  参数array：数组名n：数值类型，可选项，指定要得到数组哪一维的上界。缺省值为1 返回值Long。函数执行成功时返回array数组第n维的上界。如果n的值超过了指定数组的最大维数，那么该函数返回-1。如果任何参数的值为NULL，UpperBound()函数返回NULL。

• PrintY()
  功能返回打印光标的y坐标位置。
  语法PrintY ( printjobnumber )
  参数printjobnumber：用PrintOpen()函数打开的打印作业号返回值Integer。函数执行成功时返回打印光标的y坐标位置，以千分之一英寸为单位，发生错误时返回-1。如果任何参数的值为NULL，PrintY()函数返回NULL。

• RegistryValues()
  功能得到与指定键相关的一组值名。该函数在Windows 3.1中无效。
  语法RegistryValues ( key, valuename )
  参数key：string类型，指定键名valuename：字符串数组变量，用于保存值名返回值Integer。函数执行成功时返回1，发生错误时返回-1。用法在valuename 参数中可以使用定长数组，也可以使用动态数组。使用动态数组时，数组的上界反映了能够得到的值名个数。当使用定长数组时，其数组元素个数必须足够多，保证能够容纳所有值名，但是，在具体得到值名之前，没有办法能够预先知道实际值名个数。为了唯一地标识某个键，在key参数中，可以从根键开始依次指定各级父键，各键之间使用反斜杠（/）分隔。