Functions.FWriteLine 方法 (IntPtr, String)

将字符串、回车符和换行符写入打开的文件。

命名空间： XSharp.Core
程序集： XSharp.Core (在 XSharp.Core.dll 中) 版本：2.22 GA

语法

 FUNCTION FWriteLine(
	ptrHandle AS IntPtr,
	cBuffer AS STRING
) AS DWORD

public static uint FWriteLine(
	IntPtr ptrHandle,
	string cBuffer
)

查看代码

参数

ptrHandle: 类型：IntPtr
要写入的文件句柄。
cBuffer: 类型：String
要写入的字符串。

返回值

类型：UInt32
写入的字节数。
如果返回值等于 nBytes + 2，则操作成功。
如果返回值小于 nBytes + 2 或为 0，则表示 cBuffer 的长度小于 nBytes，或磁盘已满，或发生了其他错误。

备注

FWriteLine() 是一个低级文件函数，从字符串缓冲区向打开的文件写入数据。您可以选择写入整个缓冲区或部分缓冲区内容。写入从当前文件位置开始，函数返回实际写入的字节数。此函数假定处理原始二进制数据，并不依赖于 SetAnsi() 的状态。相反，FWriteText() 和 FWrite4() 则依赖于 SetAnsi()。

示例

此示例使用 FWriteLine() 从文件开头开始写入行。
回车符/换行符对使返回值增加 2：

复制

1hF := FOpen2("c:\data\sales", FO_READWRITE)
2IF hF != F_ERROR
3    ? FWriteLine(hF, "Line1")        // 7
4    ? FWriteLine(hF, "Line1", 2)    // 4
5ENDIF

参见

引用

FWriteLine3(IntPtr, String, UInt32)