powerBuilder fileWrite()

FileWrite()

##功能向指定文件中写数据。

语法FileWrite (fileno , variable )

1、参数fileno：integer类型，指定文件句柄（由FileOpen()函数得到）

2、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。