API File.NVM.ReadByte: Difference between revisions

Latest revision as of 14:11, 13 July 2026

	ReadByte
Reads a single byte from the NVM, -1 if empty
- HANDLE	FileHandle
The handle of an open file
- ULONG	Address
Position in the file in bytes
- INT	Return

Add to a calculation icon:

result = ::File.NVM.ReadByte(filehandle, address)

@@ Line 1: / Line 1: @@
-<sidebar>API contents</sidebar>
+{| class="mtx-class-macrotable wikitable"
-Reads a single byte from the NVM, -1 if empty
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''ReadByte'''
+|-
+| colspan="2" | Reads a single byte from the NVM, -1 if empty&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
+| width="90%" | FileHandle
+|-
+| colspan="2" | The handle of an open file&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG
+| width="90%" | Address
+|-
+| colspan="2" | Position in the file in bytes&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
-===Parameters===
+==Detailed description==
-''[[Variable types|HANDLE]] FileHandle''
-:The handle of an open file
-''[[Variable types|ULONG]] Address''
-:Position in the file in bytes
-===Return value===
-[[Variable types|INT]]
-No additional information
+==Examples==
+===Calling in a calculation===
-===Detailed description===
-''No additional information''
-===Examples===
-====Calling in a calculation====
 * Declare a variable 'result' of type INT
-* Add to a calculation icon: result = ::File.NVM.ReadByte(filehandle, address)
+* Add to a calculation icon: <pre class="brush:[cpp]">result = ::File.NVM.ReadByte(filehandle, address)</pre>