fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytesfwrite_bytes (算子)

名称

fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytesfwrite_bytes — 将字节写入二进制文件。

签名

fwrite_bytes( : : FileHandle, DataToWrite : NumberOfBytesWritten)

描述

算子 fwrite_bytesfwrite_bytesFwriteBytesFwriteBytesFwriteBytesfwrite_bytes writes bytes to the output file defined by FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle. The output file must have been opened with open_fileopen_fileOpenFileOpenFileOpenFileopen_file in binary format.

The data to be written to the file is specified as DataToWriteDataToWriteDataToWriteDataToWritedataToWritedata_to_write。

The number of bytes that are written to the file is returned in NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWrittennumber_of_bytes_written。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (输入控制) file → (handle)

File handle.

DataToWriteDataToWriteDataToWriteDataToWritedataToWritedata_to_write (输入控制) integer-array → (integer)

Data to be written to the file.

NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWrittennumber_of_bytes_written (输出控制) integer → (integer)

Number of bytes written to the output binary file.

示例（HDevelop）

* Write a binary file byte by byte.
open_file (Filename, 'append_binary', FileHandle)
fwrite_bytes(FileHandle, [0x97, 99, 102], BytesWritten)
close_file (FileHandle)

结果

If an output file is open in binary mode and no file write error occurs, the operator fwrite_bytesfwrite_bytesFwriteBytesFwriteBytesFwriteBytesfwrite_bytes 返回 2 ( H_MSG_TRUE )。否则，将抛出异常。

可能的前趋

open_fileopen_fileOpenFileOpenFileOpenFileopen_file

可能的后继

close_fileclose_fileCloseFileCloseFileCloseFileclose_file

替代

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string

另见

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, close_fileclose_fileCloseFileCloseFileCloseFileclose_file, fread_bytesfread_bytesFreadBytesFreadBytesFreadBytesfread_bytes

模块

基础

算子