POWER BUILDER 文件操作函数小集.docx

POWER BUILDER 文件操作函数小集.docx

《POWER BUILDER 文件操作函数小集.docx》由会员分享，可在线阅读，更多相关《POWER BUILDER 文件操作函数小集.docx（24页珍藏版）》请在冰豆网上搜索。

POWERBUILDER文件操作函数小集

PowerBuilder函数小集（文件操作）  

2009-07-0618:

13:

17|  分类：

学习类|  标签：

|字号大中小 订阅

FileClose（）

功能关闭先前用FileOpen（）函数打开的文件。

语法FileClose（fileno）

参数fileno：

integer，指定要关闭文件的文件句柄，该句柄使用FileOpen（）函数打开文件时得到返回值Integer。

函数执行成功时返回1，发生错误时返回-1。

如果fileno参数的值为NULL，那么FileClose（）函数返回NULL。

---------------------------------------------------------------------

FileDelete（）

功能删除指定的文件。

语法FileDelete（filename）

参数filename：

string类型，指定要删除文件的文件名，其中可以包含路径返回值Boolean。

函数执行成功时返回TRUE，发生错误时返回FALSE。

如果filename参数的值为NULL，那么FileDelete（）函数返回NULL。

---------------------------------------------------------------------

FileExists（）

功能检查指定的文件是否存在。

语法FileExists（filename）

参数filename：

string类型，指定要检查存在性的文件的文件名，其中可以包含路径返回值Boolean。

如果指定文件存在时返回TRUE，不存在时返回FALSE。

如果filename参数的值为NULL，那么FileExists（）函数返回NULL。

用法如果filename参数指定的文件被另一个应用加锁锁住，那么FileExists（）函数也将返回FALSE。

---------------------------------------------------------------------

FileLength（）

功能得到指定文件的长度（以字节为单位）。

语法FileLength（filename）

参数filename：

string类型，指定要得到其长度的文件的文件名，其中可以包含路径返回值Long。

函数执行成功时返回指定文件的长度（以字节为单位）。

如果指定的文件不存在，函数返回-1。

如果filename参数的值为NULL，那么FileLength（）函数返回NULL。

---------------------------------------------------------------------

FileOpen（）

功能以指定的读写方式打开指定的文件，同时返回该文件的句柄。

语法FileOpen（filename{,filemode{,fileaccess{,filelock{,writemode,{creator,filetype}}}}}）

参数filename：

string类型，指定要打开文件的名称，其中可以包含路径filemode：

FileMode枚举类型，可选项，指定文件打开方式。

有效取值为：

?

LineMode!

-缺省值，行模式；?

StreamMode!

-流模式fileaccess：

FileAccess枚举类型，可选项，指定文件访问方式。

有效取值为：

?

Read!

-缺省值，只读方式，这样打开的文件只能进行读操作；?

Write!

-只写方式，这样打开的文件只能进行写操作?

filelock：

FileLock枚举类型，可选项，指定文件加锁方式。

有效取值为：

nLockReadWrite!

-缺省值，只有打开该文件的用户能够访问该文件，其它用户对该文件的访问均被拒绝；nLockRead!

-只有打开该文件的用户能够读该文件，但其它任何用户均可写该文件；nLockWrite!

-只有打开该文件的用户能够写该文件，但其它任何用户均可读该文件；nShared!

-所有用户均可读写该文件writemode：

WriteMode枚举类型，可选项，当fileaccess参数指定为Write!

时，该参数指定在指定文件已经存在时数据的添加方式。

有效取值为：

?

Append!

-缺省值，将数据添加到原文件尾部；?

Replace!

-覆盖原有数据creator：

可选项，用于Macintosh机，使用四个字符的字符串指定文件的创建者。

指定该参数后，必须同时指定filetype参数filetype：

可选项，用于Macintosh机，使用四个字符的字符串指定文件类型返回值Integer。

函数执行成功时返回打开文件的句柄，随后的文件操作函数利用该句柄完成对文件的操作。

发生错误时函数返回-1。

如果任何参数的值为NULL，那么FileOpen（）函数返回NULL。

用法当文件以行模式打开时，每执行一次FileRead（）函数读取一行数据；每执行一次FileWrite（）函数，该函数自动在写出的字符串末尾增加一个回车（CR）换行（LF）符（这是应用程序在Windows系统中运行时的情况，在UNIX下只加一个换行字符）。

当文件以流模式打开时，执行一次FileRead（）函数读取32,765个字节的数据，如果余下数据没有这么多，那么FileRead（）函数就读取所有余下的数据；执行一次FileWrite（）函数时，最多可写入32,765个字节的数据，并且不添加回车换行字符。

当文件以写方式使用FileOpen（）函数打开时，如果指定的文件不存在，那么FileOpen（）函数创建该文件。

---------------------------------------------------------------------

FileRead（）

功能从指定文件中读取数据。

语法FileRead（fileno,variable）

参数fileno：

integer类型，指定文件句柄（由FileOpen（）函数得到）variable：

string或blob类型的变量，用于保存读取的数据返回值Integer。

函数执行成功时返回读取的字符数或字节数；如果在读取任何字符前读到了文件结束符（EOF），则FileRead（）函数返回-100；当指定文件以行模式打开时，如果在读取任何字符之前遇到了回车（CR）或换行（LF）字符，则FileRead（）函数返回0。

如果发生其它错误，FileRead（）函数返回-1。

如果任何参数的值为NULL，那么FileRead（）函数返回NULL。

用法当指定文件以行模式（LineMode）打开时，FileRead（）函数一次读取一行数据，并把它保存到参数variable中，然后跳过行结束符（回车换行符，操作系统不同，使用的字符也不同），把文件指针移动到下一行的起始位置。

当文件以流模式（StreamMode）打开时，FileRead（）函数或一直读取到文件结尾，或读取32,765字节的数据，决定于两者哪个数据长度更短些。

---------------------------------------------------------------------

FileSeek（）

功能将文件指针移动到指定位置。

读写文件时相应函数会自动移动文件指针。

语法FileSeek（fileno,position,origin）

参数fileno：

integer类型，指定文件句柄（由FileOpen（）函数得到）position：

long类型，指定相对于origin参数指定位置的新位置偏移量，以字节为单位origin：

SeekType枚举类型，指定从哪里开始移动文件指针，即指针移动的基准。

有效取值为：

?

FromBeginning!

-缺省值，从文件开头移动指针；?

FromCurrent!

-从当前位置移动文件指针；?

FromEnd!

-从文件结尾处移动文件指针返回值Long。

函数执行成功时返回指针移动后的指针位置。

如果任何参数的值为NULL，那么FileSeek（）函数返回NULL。

---------------------------------------------------------------------

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缺省值为：

"AllFiles（*.*）,*.*"其中，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缺省值为：

"AllFiles（*.*）,*.*"其中，description说明扩展名的意义，比如“所有文件”、“文本文件”等。

你可以根据需要指定在打开文件对话框中显示的文件名类型。

当需要指定多种文件类型时，各类型之间使用逗号分隔，例如：

"PIF文件,*.PIF,批处理文件,*.BAT"需要注意的是，该函数只是得到一个文件名，而并没有打开文件，需要打开文件时，依然需要使用FileOpen（）函数。

PowerBuilder常用字符串函数

∙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字符串，但并不增加其它字符。

窗口操作函数

Close（）

功能关闭窗口并释放窗口以及窗口上的控件所占据的内存。

语法Close（windowname）

参数windowname：

要关闭窗口的名称返回值Integer。

函数执行成功时返回1，发生错误时返回-1。

如果参数windowname的值为NULL，Close（）函数返回NULL。

用法应用程序使用Open（）或其它Open簇函数打开窗口后，不需要窗口时，可以使用Close（）关闭窗口并释放窗口以及窗口上所有控件占据的内存。

Close（）函数的执行过程为：

如果要关闭窗口的CloseQuery和/或Close事件已经编写了事件处理程序，那么执行这些事件处理程序，从屏幕上删除要关闭的窗口、关闭窗口、之后执行调用Close（）函数语句后面的语句。

当窗口被关闭后，应用程序就不能再访问已经关闭窗口的属性、实例变量、对象函数、以及窗口上的控件了。

如果关闭窗口后应用程序依然访问上述特性，那么将引发运行错误。

当然，应用程序也可以阻止窗口被关闭，方法很简单，只要在欲阻止关闭窗口的CloseQuery事件处理程序中使用RETURN语句返回1即可，格式为：

RETURN1

---------------------------------------------------------------------

CloseWithReturn（）

功能关闭窗口并将返回值保存在Message对象中，该函数只能对响应窗口使用。

语法CloseWithReturn（windowname,returnvalue）

参数windowname：

要关闭窗口的名称returnvalue：

指定关闭窗口时保存到Message对象中的值，调用CloseWithReturn（）函数的代码段通过查看Message对象属性的值得到关闭窗口时被关闭窗口传递的值。

returnvalue参数必须是下述三种类型之一：

String、Numeric、PowerObject返回值Integer。

函数执行成功时返回1，发生错误时返回-1。

如果参数任何的值为NULL，CloseWithReturn（）函数返回NULL。

---------------------------------------------------------------------

Open（）

功能打开窗口。

该函数有两种语法格式：

语法一、打开编程时已知数据类型的窗口对象；

语法二、打开程序运行后才能确定数据类型的窗口对象。

下面分别予以介绍：

语法一、打开编程时已知