Functions.FWriteLine 方法 | |
将字符串、回车符和换行符写入打开的文件。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION FWriteLine(
ptrHandle,
cBuffer,
nBytes
) AS DWORD CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static uint FWriteLine(
__Usual ptrHandle = default,
__Usual cBuffer = default,
__Usual nBytes = default
)
查看代码参数
- ptrHandle (Optional)
- 类型:__Usual
要写入的文件句柄。 - cBuffer (Optional)
- 类型:__Usual
要写入的字符串。 - nBytes (Optional)
- 类型:__Usual
cBuffer 中要写入的字节数,写入从当前文件指针位置开始。
如果未指定 nBytes,则使用 SLen(cBuffer) 的值。
返回值
类型:
UInt32
写入的字节数。
如果返回值等于
nBytes + 2,则操作成功。
如果返回值小于
nBytes + 2 或为 0,则表示
cBuffer 的长度小于
nBytes,或磁盘已满,或发生了其他错误。
备注
FWriteLine() 是一个低级文件函数,从字符串缓冲区向打开的文件写入数据。您可以选择写入整个缓冲区或部分缓冲区内容。写入从当前文件位置开始,函数返回实际写入的字节数。
此函数假定处理原始二进制数据,并不依赖于 SetAnsi() 的状态。相反,FWriteText() 和 FWrite4() 则依赖于 SetAnsi()。
备注 提示: |
---|
这个函数是为了兼容性而包含的。我们不建议使用静态内存进行文件 I/O 操作。
我们建议您使用接受字节数组参数的函数重载。
|
示例
此示例使用 FWriteLine() 从文件开头开始写入行。
回车符/换行符对使返回值增加 2:
1hF := FOpen2("c:\data\sales", FO_READWRITE)
2IF hF != F_ERROR
3 ? FWriteLine(hF, "Line1")
4 ? FWriteLine(hF, "Line1", 2)
5ENDIF
参见