《PB文件操作函数》由会员分享，可在线阅读，更多相关《PB文件操作函数（8页珍藏版）》请在金锄头文库上搜索。
1、pb 函数库之文件操作函数 FileClose() 功能关闭先前用 FileOpen()函数打开的文件。 语法 FileClose ( fileno ) 参数 fileno：integer，指定要关闭文件的文件句柄，该句柄使用 FileOpen()函数打开文件时 得到返回值 Integer。函数执行成功时返回 1，发生错误时返回-1。如果 fileno 参数的值为 NULL，那么 FileClose()函数返回 NULL。 -FileDelete() 功能删除指定的文件。 语法 FileDelete ( filename ) 参数 filename：string 类型，指定要删除文件的文件名，
2、其中可以包含路径返回值 Boolean。函数执行成功时返回 TRUE，发生错误时返回 FALSE。如果 filename 参数的值为 NULL，那么 FileDelete()函数返回 NULL。 -FileExists() 功能检查指定的文件是否存在。 语法 FileExists ( filename ) 参数 filename：string 类型，指定要检查存在性的文件的文件名，其中可以包含路径返回值 Boolean。如果指定文件存在时返回 TRUE，不存在时返回 FALSE。如果 filename 参数的值 为 NULL，那么 FileExists()函数返回 NULL。用法如果 file
3、name 参数指定的文件被另一个 应用加锁锁住，那么 FileExists()函数也将返回 FALSE。 -FileLength() 功能得到指定文件的长度（以字节为单位） 。 语法 FileLength ( filename ) 参数 filename：string 类型，指定要得到其长度的文件的文件名，其中可以包含路径返回值 Long。函数执行成功时返回指定文件的长度（以字节为单位） 。如果指定的文件不存在， 函数返回-1。如果 filename 参数的值为 NULL，那么 FileLength()函数返回 NULL。 -FileOpen() 功能以指定的读写方式打开指定的文件，同时返回该
4、文件的句柄。 语法 FileOpen(filename,filemode,fileaccess,filelock,writemode,creator,filetype) 参数 filename：string 类型，指定要打开文件的名称，其中可以包含路径 filemode：FileMode 枚举类型，可选项，指定文件打开方式。有效取值为：?LineMode! - 缺省值，行模式；?StreamMode! - 流模式 fileaccess：FileAccess 枚举类型，可选项，指定 文件访问方式。有效取值为：?Read! - 缺省值，只读方式，这样打开的文件只能进行读操 作；?Write! -
5、只写方式，这样打开的文件只能进行写操作?filelock：FileLock 枚举类型，可 选项，指定文件加锁方式。有效取值为：n LockReadWrite! - 缺省值，只有打开该文件的用 户能够访问该文件，其它用 户对该文件的访问均被拒绝；n LockRead! - 只有打开该文件的用户能够读该文件，但其它任何用户均可写该文件；n LockWrite! - 只有打开该文件的用 户能够写该文件，但其它任何用户均可读该文件；n Shared! - 所有用户均可读写该文件 writemode：WriteMode 枚举类型，可选项，当 fileaccess 参数指定为 Write!时，该参数指定
6、在指定文件已经存在时数据的添加方式。有效取值为：?Append! - 缺省值，将数据添加到 原文件尾部；?Replace! - 覆盖原有数据 creator：可选项，用于 Macintosh 机，使用四个字 符的字符串指定文件的创建者。指定该参数后，必须同时指定 filetype 参数 filetype：可选 项，用于 Macintosh 机，使用四个字符的字符串指定文件类型返回值 Integer。函数执行成 功时返回打开文件的句柄，随后的文件操作函数利用该句柄完成对文件的操作。发生错误 时函数返回-1。如果任何参数的值为 NULL，那么 FileOpen()函数返回 NULL。用法当文件 以
7、行模式打开时，每执行一次 FileRead()函数读取一行数据；每执行一次 FileWrite()函数， 该函数自动在写出的字符串末尾增加一个回车（CR）换行（LF）符（这是应用程序在 Windows 系统中运行时的情况，在 UNIX 下只加一个换行字符） 。当文件以流模式打开时， 执行一次 FileRead()函数读取 32,765 个字节的数据，如果余下数据没有这么多，那么 FileRead()函数就读取所有余下的数据；执行一次 FileWrite()函数时，最多可写入 32,765 个 字节的数据，并且不添加回车换行字符。当文件以写方式使用 FileOpen()函数打开时，如 果指定的文
8、件不存在，那么 FileOpen()函数创建该文件。 -FileRead() 功能从指定文件中读取数据。 语法 FileRead ( fileno, variable ) 参数 fileno：integer 类型，指定文件句柄（由 FileOpen()函数得到）variable：string 或 blob 类型的变量，用于保存读取的数据返回值 Integer。函数执行成功时返回读取的字符数或字 节数；如果在读取任何字符前读到了文件结束符（EOF） ，则 FileRead()函数返回-100；当 指定文件以行模式打开时，如果在读取任何字符之前遇到了回车（CR）或换行（LF）字符， 则 FileR
9、ead()函数返回 0。如果发生其它错误，FileRead()函数返回-1。如果任何参数的值为 NULL，那么 FileRead()函数返回 NULL。用法当指定文件以行模式（Line Mode）打开时， FileRead()函数一次读取一行数据，并把它保存到参数 variable 中，然后跳过行结束符（回 车换行符，操作系统不同，使用的字符也不同） ，把文件指针移动到下一行的起始位置。当 文件以流模式（Stream Mode）打开时，FileRead()函数或一直读取到文件结尾，或读取 32,765 字节的数据，决定于两者哪个数据长度更短些。 -FileSeek() 功能将文件指针移动到指定
10、位置。读写文件时相应函数会自动移动文件指针。 语法 FileSeek ( fileno, position, origin ) 参数 fileno：integer 类型，指定文件句柄（由 FileOpen()函数得到）position：long 类型，指 定相对于 origin 参数指定位置的新位置偏移量，以字节为单位 origin：SeekType 枚举类型， 指定从哪里开始移动文件指针，即指针移动的基准。有效取值为：?FromBeginning! - 缺省 值，从文件开头移动指针；?FromCurrent! - 从当前位置移动文件指针；?FromEnd! - 从文 件结尾处移动文件指针返回
11、值 Long。函数执行成功时返回指针移动后的指针位置。如果任 何参数的值为 NULL，那么 FileSeek()函数返回 NULL。 -FileWrite() 功能向指定文件中写数据。 语法 FileWrite (fileno , variable ) 参数 fileno：integer 类型，指定文件句柄（由 FileOpen()函数得到）variable：string 或 blob 类型，其值将写入 fileno 参数指定的文件返回值 Integer。函数执行成功时返回写入文件的 字符或字节数，发生错误时返回-1。如果任何参数的值为 NULL，那么 FileWrite()函数返回 NULL
12、。用法 FileWrite()函数从当前文件指针开始写入指定数据，写入之后，将文件指针调 整到刚刚写入数据的下一个字节位置。当文件以 writemode 参数设置为 Replace!方式打开 时，文件指针最初位于文件的开头位置；当文件以 writemode 参数设置为 Append!方式打开 时，文件指针最初位于文件的结尾位置。当文件以行模式打开时，执行。当文件以行模式打开时，执行 FileWrite()函数时，函数时， 该函数自动在每次写入数据的后面加上回车换行符，并把文件指针移动到回车换行符后面。该函数自动在每次写入数据的后面加上回车换行符，并把文件指针移动到回车换行符后面。 当文件以流模
13、式打开时，FileWrite()函数一次最多写入 32,765 个字节。如果 variable 参数中 数据的长度超过了 32,765 个字节，那么 FileWrite()函数只向文件中写入前 32,765 个字符并 返回 32,765。 FileClose()FileClose() 功能关闭先前用 FileOpen()函数打开的文件。 语法 FileClose ( fileno ) 参数 fileno：integer，指定要关闭文件的文件句柄，该句柄使用 FileOpen()函数打开文件时得到返回值 Integer。函数执行成功时 返回 1，发生错误时返回-1。如果 fileno 参数的值为
14、 NULL，那么 FileClose()函数返回 NULL。 FileDelete()FileDelete() 功能删除指定的文件。 语法 FileDelete ( filename ) 参数 filename：string 类型，指定要删除文件的文件名，其中可以包含 路径返回值 Boolean。函数执行成功时返回 TRUE，发生错误时返回 FALSE。如果 filename 参数的值为 NULL，那么 FileDelete()函数返回 NULL。FileExists()FileExists() 功能检查指定的文件是否存在。 语法 FileExists ( filename ) 参数 filename：string 类型，指定要检查存在性的文件的文件名，其中 可以包含路径返回值 Boolean。如果指定文件存在时返回 TRUE，不 存在时返回 FALSE。如果 filename 参数的值为 NULL，那么 FileExists()函数返回 NULL。用法如果 filename 参数指定的文 件被另一个应用加锁锁住，那么 FileExists()函数也将返回 FALSE。 FileLength()FileLength() 功能得到
