Difference between revisions of "Lua:wideStringToByteTable"
m |
|||
(4 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Lua]] | [[Category:Lua]] | ||
− | '''function''' wideStringToByteTable(''String'') ''':''' | + | '''function''' wideStringToByteTable(''String'') ''':''' Table |
− | Converts a string | + | Converts a string to a wide string (UTF-16/Unicode) and then to a table of bytes. |
− | + | ===Function Parameters=== | |
− | === Function Parameters === | + | {|width="85%" cellpadding="10%" cellspacing="0" border="0" |
− | {|width="85%" cellpadding="10 | ||
!align="left"|Parameter | !align="left"|Parameter | ||
!align="left"|Type | !align="left"|Type | ||
Line 12: | Line 11: | ||
|- | |- | ||
|String | |String | ||
− | | | + | |String |
− | |The | + | |The string to convert to a wide string and then to a byte table. |
|} | |} | ||
+ | ===Returns=== | ||
+ | Table — A table containing the bytes representing the wide string (UTF-16/Unicode). | ||
+ | |||
+ | ===Explanation=== | ||
+ | |||
+ | The "ToByteTable" functions convert a value (such as an integer or floating-point number) into a table of bytes that represent how the value is stored in memory. | ||
− | + | For example, if you use <code>wordToByteTable(1337)</code>: | |
− | |||
− | |||
− | |||
− | |||
+ | - The decimal number <code>1337</code> is <code>0x0539</code> in hexadecimal. | ||
+ | - Computers typically use little-endian order, meaning the least significant byte comes first. | ||
+ | - So, <code>0x0539</code> is split into two bytes: <code>0x39</code> (57 in decimal) and <code>0x05</code> (5 in decimal). | ||
+ | - The resulting byte table is <code>{0x39, 0x05}</code> or <code>{57, 5}</code>. | ||
− | + | This means: | |
− | + | - <code>bytes[1] = 0x39</code> (the low byte) | |
− | + | - <code>bytes[2] = 0x05</code> (the high byte) | |
− | |||
− | |||
− | + | This process applies to all "ToByteTable" functions: | |
− | + | They break down the value into its raw bytes, ordered from least significant to most significant (little-endian). | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | ===Examples=== | ||
+ | <pre> | ||
+ | local bytes = wideStringToByteTable("ABC") | ||
+ | for i, b in ipairs(bytes) do | ||
+ | print(string.format("Byte %d: %02X", i, b)) | ||
+ | end | ||
+ | -- Output: 6 bytes representing "A", "B", "C" as UTF-16LE (e.g., 41 00 42 00 43 00) | ||
+ | </pre> | ||
{{LuaSeeAlso}} | {{LuaSeeAlso}} | ||
=== Related Functions === | === Related Functions === | ||
− | * [[ | + | * [[ansiToUtf8]] |
− | * [[ | + | * [[utf8ToAnsi]] |
− | * [[ | + | * [[translate]] |
− | + | {{ReadWriteMemory}} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 17:35, 11 July 2025
function wideStringToByteTable(String) : Table
Converts a string to a wide string (UTF-16/Unicode) and then to a table of bytes.
Function Parameters[edit]
Parameter | Type | Description |
---|---|---|
String | String | The string to convert to a wide string and then to a byte table. |
Returns[edit]
Table — A table containing the bytes representing the wide string (UTF-16/Unicode).
Explanation[edit]
The "ToByteTable" functions convert a value (such as an integer or floating-point number) into a table of bytes that represent how the value is stored in memory.
For example, if you use wordToByteTable(1337)
:
- The decimal number 1337
is 0x0539
in hexadecimal.
- Computers typically use little-endian order, meaning the least significant byte comes first.
- So, 0x0539
is split into two bytes: 0x39
(57 in decimal) and 0x05
(5 in decimal).
- The resulting byte table is {0x39, 0x05}
or {57, 5}
.
This means:
- bytes[1] = 0x39
(the low byte)
- bytes[2] = 0x05
(the high byte)
This process applies to all "ToByteTable" functions: They break down the value into its raw bytes, ordered from least significant to most significant (little-endian).
Examples[edit]
local bytes = wideStringToByteTable("ABC") for i, b in ipairs(bytes) do print(string.format("Byte %d: %02X", i, b)) end -- Output: 6 bytes representing "A", "B", "C" as UTF-16LE (e.g., 41 00 42 00 43 00)
See also[edit]
Related Functions[edit]
- ansiToUtf8
- utf8ToAnsi
- translate
- readBytes
- readSmallInteger
- readInteger
- readQword
- readPointer
- readFloat
- readDouble
- readString
- writeBytes
- writeSmallInteger
- writeInteger
- writeQword
- writeFloat
- writeDouble
- writeString
- readBytesLocal
- readIntegerLocal
- readQwordLocal
- readPointerLocal
- readFloatLocal
- readDoubleLocal
- readStringLocal
- writeBytesLocal
- writeIntegerLocal
- writeQwordLocal
- writeFloatLocal
- writeDoubleLocal
- writeStringLocal
- wordToByteTable
- dwordToByteTable
- qwordToByteTable
- floatToByteTable
- doubleToByteTable
- stringToByteTable
- wideStringToByteTable
- byteTableToWord
- byteTableToDword
- byteTableToQword
- byteTableToFloat
- byteTableToDouble
- byteTableToString
- byteTableToWideString