PB函数大全八

FileWrite()
功能向指定文件中写数据。
语法FileWrite (fileno , variable )
参数fileno：integer类型，指定文件句柄（由FileOpen()函数得到）variable：string或blob类型，其值将写入fileno参数指定的文件返回值Integer。函数执行成功时返回写入文件的字符或字节数，发生错误时返回-1。如果任何参数的值为NULL，那么FileWrite()函数返回NULL。用法FileWrite()函数从当前文件指针开始写入指定数据，写入之后，将文件指针调整到刚刚写入数据的下一个字节位置。当文件以writemode参数设置为Replace!方式打开时，文件指针最初位于文件的开头位置；当文件以writemode参数设置为Append!方式打开时，文件指针最初位于文件的结尾位置。当文件以行模式打开时，执行FileWrite()函数时，该函数自动在每次写入数据的后面加上回车换行符，并把文件指针移动到回车换行符后面。当文件以流模式打开时，FileWrite()函数一次最多写入32,765个字节。如果variable参数中数据的长度超过了32,765个字节，那么FileWrite()函数只向文件中写入前32,765个字符并返回32,765。
GetFileOpenName()
功能显示打开文件对话框，让用户选择要打开的文件。
语法GetFileOpenName(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，那么GetFileOpenName()函数返回NULL。
用法filter参数的格式为：description,*. ext缺省值为："All Files (*.*),*.*"其中，description说明扩展名的意义，比如“所有文件”、“文本文件”等。你可以根据需要指定在打开文件对话框中显示的文件名类型。当需要指定多种文件类型时，各类型之间使用逗号分隔，例如："PIF 文件, *.PIF, 批处理文件, *.BAT"需要注意的是，该函数只是得到一个文件名，而并没有打开文件，需要打开文件时，依然需要使用FileOpen()函数。
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()函数。
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参数的写法与正则表达式十分相似，它由元字符和普通字符组成。每个元字符都有不同的匹配含义，普通字符则与其自身相匹配。下面是匹配模式中使用的元字符及其意义：
^指示字符串的开始，例如，^asd表示以asd开头的字符串，字符串asdfgh与模式^asd匹配，而字符串basdfg与模式^asd不匹配。
$指示字符串的结束，例如，red$表示所有以red结束的字符串均与该模式匹配，而redo与模式red$不匹配。
.匹配任意单个字符，例如，^&&$匹配任何六个字符组成的字符串。
[]匹配括号中列出的字符，例如，^[ABC]$匹配由一个字符组成的字符串，其值只能是A或B或C。
-与方括号一起，指定匹配字符的范围，例如，^[A-Z]$只匹配那些由一个大写字母组成的字符串。方括号里还可以使用^字符，表示匹配不在指定范围内的任何字符，例如，[^0-9]匹配除数字外的任何字符。
*，+，?这些符号跟在一个字符后面表示该字符可以出现的次数。星号（*）表示可以出现0次或任意次；加号（+）表示可以出现多次，但至少出现一次；问号（?）表示出现0次或一次。例如，A*匹配0个或多个A（没有A、A、AA、AAA、AAAA、**）；A+匹配1个或多个A（A、AA、AAA、AAAA、**）；A?匹配空串或1个A。
/斜杠（/）是转义字符，它去掉特殊字符的特殊含义，比如，模式/$匹配字符$，模式//匹配字符/。
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。　
GetCommandDDE()
功能得到DDE客户应用发送的命令。
语法GetCommandDDE ( string )
参数string：string类型的变量，用于保存DDE客户应用发送的命令返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果string参数的值为NULL， GetCommandDDE()函数返回NULL。用法当DDE客户应用向DDE服务器应用发送一条命令时，这个动作将触发DDE服务器应用活动窗口的RemoteExec事件，在这个事件的事件处理程序中，可以使用GetCommandDDE()函数得到DDE客户应用发送的命令。
GetCommandDDEOrigin()
功能确定哪一个DDE客户应用向服务器发送了命令。
语法GetCommandDDEOrigin ( applstring )
参数applstring：string变量，用于保存发送命令的DDE客户应用的名称返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果applstring参数的值为 NULL，GetCommandDDEOrigin()函数返回NULL。
GetDataDDE()
功能得到DDE客户应用发送的数据。
语法GetDataDDE ( string )
参数string：string类型变量，用于保存接收到的数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL， GetDataDDE()函数返回NULL。
GetDataDDEOrigin()功能确定哪个DDE客户应用发送了数据。
语法GetDataDDEOrigin ( applstring, topicstring, itemstring )
参数applstring：string类型变量，用于保存客户应用的名称topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可能是R1C2）返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。
RespondRemote()
功能向客户端应用指明最近的命令或数据是否已经接收。
语法RespondRemote ( boolean )
参数boolean：其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()函数返回NULL。

SetDataDDE()
功能向DDE客户应用发送数据。
语法SetDataDDE ( string {, applname, topic, item } )
参数string：指定要发送到DDE客户应用的数据applname：string类型，可选项，指定接收数据的客户应用的DDE名称topic：string类型，可选项，指定基础数据组item：string类型，可选项，指定基础数据组中的数据项返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1函数调用的环境不对-2数据未被接收如果任何参数的值为NULL，SetDataDDE()函数返回NULL。
StartServerDDE()
功能将当前应用设置为DDE服务器。
语法StartServerDDE ( { windowname, } applname, topic {, item } )
参数windowname：可选项，指定服务器窗口名，缺省值为当前窗口applname：当前应用的DDE名称topic：string类型，指定DDE客户应用能够引用的基本数据组item：由逗号（,）分隔的一个或多个字符串，指定服务器应用支持的数据项返回值Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用已经设置为DDE服务器。如果任何参数的值为NULL，StartServerDDE()函数返回NULL。
StopServerDDE()
功能停止当前应用的DDE服务器功能。执行该函数后，发给该应用的任何DDE客户应用请求都将失败。
语法StopServerDDE ( { windowname, } applname, topic )
参数windowname：可选项，指定要关闭服务器功能的服务器窗口名，缺省值为当前窗口，如果当前应用有多个服务器窗口，那么必须指定该参数applname：当前应用的DDE名称topic：string类型，应该与StartServerDDE()中对应参数相同返回值Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用未曾作为DDE服务器启动。如果任何参数的值为NULL，StopServerDDE()函数返回NULL。
IsAllArabic()
功能确定指定的字符串是否全部由阿拉伯文字符组成，该函数只能在PowerBuilder的阿拉伯文版本中使用。
语法IsAllArabic ( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由阿拉伯文字符组成，那么函数返回TRUE，否则返回FALSE。字符串中如果包含数字、空格、标点符号，那么该函数也返回FALSE。如果PowerBuilder不是阿拉伯文版本，该函数总是返回FALSE。
IsAllHebrew()
功能确定指定的字符串是否全部由希伯来文字符组成，该函数只能在PowerBuilder的希伯来文版本中使用。
语法IsAllHebrew( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由希伯来文字符组成，那么函数返回TRUE，否则返回FALSE。字符串中如果包含数字、空格、标点符号，那么该函数也返回FALSE。如果PowerBuilder不是希伯来文版本，该函数总是返回FALSE。