X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
XSharp.Core
Functions 类
Functions 方法
_C2Hex 方法
_DebOut32 方法
_GetCmdLine 方法
_GetCmdShow 方法
_GetInst 方法
_GetPrevInst 方法
_Like 方法
_Quit 方法
_SplitPath 方法
_Val 方法
AbsInt 方法
AbsLong 方法
AbsReal4 方法
AbsReal8 方法
AbsShort 方法
AdjustFName 方法
AdjustFNameA 方法
AllTrim 方法
AltD 方法
AmPm 方法
Ansi2Oem 方法
Ansi2OemA 方法
Ansi2OemBuff 方法
Asc 方法
AscA 方法
AscW 方法
At 方法
At2 方法
At3 方法
AtC 方法
AtC2 方法
ATCLine 方法
ATCLine2 方法
ATLine 方法
ATLine2 方法
B64EncFile 方法
B64EncString 方法
Bin2DW 方法
Bin2I 方法
Bin2Int64 方法
Bin2L 方法
Bin2Logic 方法
Bin2Ptr 方法
Bin2Real4 方法
Bin2Real8 方法
Bin2W 方法
Buffer 方法
C2Hex 方法
CharEven 方法
CharMix 方法
CharOdd 方法
CharPos 方法
Chr 方法
ChrA 方法
ChrW 方法
ConDateTime 方法
ConTime 方法
CToDt 方法
CToDtAnsi 方法
CTOL 方法
CurDir 方法
CurDrive 方法
DateTime 方法
Days 方法
DbRegisterClient 方法
DbUnRegisterClient 方法
DebOut32 方法
DecodeBase64 方法
DirChange 方法
DirMake 方法
DirRemove 方法
DiskChange 方法
DiskFree 方法
DiskName 方法
DiskSpace 方法
DosError 方法
DosErrString 方法
DtToC 方法
DtToS 方法
DW2Bin 方法
ElapTime 方法
EncodeBase64 方法
ErrorBuild 方法
ErrorLevel 方法
ErrorStack 方法
ErrString 方法
ExecName 方法
FAttr2String 方法
FAttrib 方法
FChSize 方法
FClose 方法
FCommit 方法
FConvertToFileStream 方法
FConvertToMemoryStream 方法
FCopy 方法
FCreate 方法
FCreate2 方法
FDate 方法
FEof 方法
FErase 方法
FError 方法
FException 方法
FFCount 方法
FFirst 方法
FFLock 方法
FFLock64 方法
FFlush 方法
FFUnLock 方法
FFUnLock64 方法
FGetBuffer 方法
FGetFileName 方法
FGetS 方法
FGetS2 方法
FGetStream 方法
File 方法
FName 方法
FNext 方法
FOpen 方法
FOpen2 方法
FPathName 方法
FPutS 方法
FPutS3 方法
FRead 方法
FRead3 方法
FRead4 方法
FReadLine 方法
FReadLine2 方法
FReadStr 方法
FReadText 方法
FReadText3 方法
FRename 方法
FRewind 方法
FSeek3 方法
FSize 方法
FTell 方法
FTell64 方法
FTime 方法
FWrite 方法
FWrite3 方法
FWrite4 方法
FWriteLine 方法
FWriteLine3 方法
FWriteText3 方法
GetAMExt 方法
GetAmPm 方法
GetAnsi 方法
GetChunkBase64 方法
GetCurPath 方法
GetCursorProperty 方法
GetDateFormat 方法
GetDefault 方法
GetDefaultDir 方法
GetDosError 方法
GetEnv 方法
GetFAttr 方法
GetFMask 方法
GetMacroCompiler 方法
GetMimType 方法
GetNatDLL 方法
GetPartialEnumName 方法
GetPMExt 方法
GetSQLProperty 方法
GetTimeSep 方法
GetTimeZoneDiff 方法
GetYield 方法
HardCR 方法
Hex2C 方法
HiByte 方法
HiWord 方法
I2Bin 方法
I642Bin 方法
Instr 方法
IsAlNum 方法
IsAlpha 方法
IsAlphaNum 方法
IsBDigit 方法
IsDigit 方法
IsLower 方法
IsRunningOnWindows 方法
IsSpace 方法
IsUpper 方法
IsXDigit 方法
L2Bin 方法
Left 方法
Like 方法
LoByte 方法
LockTries 方法
Logic2Bin 方法
Lower 方法
LowerA 方法
LoWord 方法
LTOC 方法
LTrim 方法
MakeDWord 方法
MakeLong 方法
MakeShort 方法
MakeWord 方法
MemLines 方法
MemoLine 方法
MemoRead 方法
MemoReadBinary 方法
MemoWrit 方法
MemoWritBinary 方法
MLCount1 方法
MLcToPos 方法
MLine 方法
MLine3 方法
MLPos2 方法
Mod 方法
ModuleName 方法
NetErr 方法
NetName 方法
NToCDoW 方法
NToCMonth 方法
Occurs 方法
Occurs2 方法
Occurs3 方法
Oem2Ansi 方法
Oem2AnsiA 方法
Oem2AnsiBuff 方法
OS 方法
ProcFile 方法
ProcLine 方法
ProcName 方法
Proper 方法
ProperA 方法
Ptr2Bin 方法
QPEncString 方法
RAt 方法
RAt2 方法
RAt3 方法
RAtLine 方法
RATLine2 方法
ReadOsVersionFromRegistry 方法
Real42Bin 方法
Real82Bin 方法
RegisterFileSearch 方法
Repl 方法
Replicate 方法
RGB 方法
Right 方法
RTrim 方法
SClone 方法
Seconds 方法
Secs 方法
SetAMExt 方法
SetAmPm 方法
SetAnsi 方法
SetBeep 方法
SetCentury 方法
SetCollation 方法
SetCompatible 方法
SetCpu 方法
SetDateCountry 方法
SetDateFormat 方法
SetDecimal 方法
SetDecimalSep 方法
SetDefault 方法
SetDefaultDir 方法
SetDeleted 方法
SetDigit 方法
SetDigitFixed 方法
SetEnv 方法
SetEpoch 方法
SetErrorLog 方法
SetErrorLogFile 方法
SetErrorStackVOFormat 方法
SetExact 方法
SetExclusive 方法
SetFieldStore 方法
SetFixed 方法
SetInternational 方法
SetMacroCompiler 方法
SetMacroDuplicatesResolver 方法
SetMath 方法
SetNatDLL 方法
SetPath 方法
SetPathArray 方法
SetPMExt 方法
SetRefresh 方法
SetSafety 方法
SetScience 方法
SetSoftSeek 方法
SetSpace 方法
SetThousandSep 方法
SetTimeFormat 方法
SetTimeSep 方法
SetUnique 方法
SetYield 方法
SLen 方法
SoundEx 方法
Space 方法
SToDt 方法
String2FAttr 方法
Stuff 方法
SubStr2 方法
SubStr3 方法
SwapByte 方法
SwapDWord 方法
SwapInt 方法
SwapInt64 方法
SwapLong 方法
SwapQWord 方法
SwapShort 方法
SwapWord 方法
SystemTypeToUsualType 方法
Time 方法
Time24 方法
Trim 方法
TruePath 方法
TString 方法
TypeString 方法
Upper 方法
UpperA 方法
UseBufferedFileStream 方法
UUDecodeLine 方法
UUEncFile 方法
UUEncLine 方法
W2Bin 方法
WorkDir 方法
点击或拖拽改变大小

Functions.FRead3 方法

X#
从文件中读取字符到分配的缓冲区中。

命名空间：  XSharp.Core
程序集：  XSharp.Core (在 XSharp.Core.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION FRead3(
	ptrHandle AS IntPtr,
	ptrBufferVar AS BYTE[],
	dwBytes AS DWORD
) AS DWORD
查看代码

参数

ptrHandle
类型：IntPtr
要读取的文件句柄。
ptrBufferVar
类型：Byte
指向用于存储从指定文件读取的数据的已分配缓冲区的指针。
此变量的长度必须大于或等于 dwBytes。 An array of bytes to store the data read from the specified file. The length of this variable must be greater than or equal to the number of bytes in the next parameter.
dwBytes
类型：UInt32
要读入缓冲区的字节数。

返回值

类型：UInt32
成功读取的字节数。
返回值小于 dwBytes 或为 0 表示已到达文件末尾或发生其他读取错误。可以使用 FError() 确定具体错误。
备注
FRead3() 与 FRead() 相同，只是缓冲区变量的名称是一个指针，不是通过引用传递的。 详细信息请参见 FRead()。 此函数假定处理原始二进制数据，不依赖于 SetAnsi() 的状态。相比之下，FReadText() 和 FRead4() 依赖于 SetAnsi()。
备注
提示 提示：
X# 运行时中的低级文件 IO 函数在后台使用 .Net 文件流。
这意味着 FOpen() 和 FCreate() 返回的文件句柄不是'正常'的文件句柄，而是用于在运行时的流集合中找到底层流对象的唯一标识符。 这也意味着你不能使用 FRead() 和 FWrite() 这样的函数，这些函数不是在 X# 运行时中创建的文件句柄。
如果你想访问底层的 FileStream，你应该调用函数 FGetStream(IntPtr)
示例
此示例在成功打开文件后使用 FRead3() 将 128 个字节读入缓冲区：
X#
复制
 1DEFINE F_BLOCK := 128
 2Function Start()
 3    LOCAL cBuffer AS PTR
 4    cBuffer := MemAlloc(F_BLOCK)
 5    IF cBuffer = NULL PTR
 6        RETURN FALSE
 7    ENDIF
 8    ptrHandle := FOpen2("temp.txt", FO_READ)
 9    IF ptrHandle = F_ERROR
10        ? DOSErrString(FError())
11        RETURN FALSE
12    ELSE
13        IF FRead3(ptrHandle, cBuffer, F_BLOCK) <paramref name="" /> F_BLOCK
14            ? DOSErrString(FError())
15            RETURN FALSE
16        ENDIF
17        FClose(ptrHandle)
18    ENDIF
19    MemFree(cBuffer)
20    RETURN TRUE
参见