点击或拖拽改变大小

Functions.FPutS 方法 (IntPtr, String, UInt32)

X#
向打开的文件写入一个字符串、回车符和换行符。

命名空间：  XSharp.Core
程序集：  XSharp.Core (在 XSharp.Core.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION FPutS(
	ptrHandle AS IntPtr,
	cBuffer AS STRING,
	nBytes AS DWORD
) AS DWORD
查看代码

参数

ptrHandle
类型：IntPtr
要写入的文件句柄。
cBuffer
类型：String
要写入的字符串。
nBytes
类型：UInt32
从当前文件指针位置开始，要写入 cBuffer 的字节数。
如果未指定 nBytes，则使用 SLen(cBuffer) 的值。

返回值

类型：UInt32
写入的字节数。
如果返回值等于 nBytes + 2，则操作成功。
如果返回值小于 nBytes + 2 或为 0，则表示 cBuffer 的长度小于 nBytes，或磁盘已满，或发生了其他错误。
备注
FPuts() 是一个低级文件函数，用于将数据从字符串缓冲区写入打开的文件。您可以写入全部或部分缓冲区内容。写入从当前文件位置开始，函数返回实际写入的字节数。 此函数假定处理原始二进制数据，不依赖于 SetAnsi() 的状态。相比之下，FWriteText() 和 FWrite4() 依赖于 SetAnsi()。
示例
此示例使用 FPuts() 从文件开头开始写入行。
回车符/换行符对使返回值增加 2：
X#
复制
1ptrHandle := FOpen2("c:\data\sales", FO_READWRITE)
2? FPuts(ptrHandle, "Line1")                //  7
3? FPuts(ptrHandle, "Line1", 2)                //  4
参见