Difference between revisions of "Lua:wideStringToByteTable"
Jump to navigation
Jump to search
m |
|||
| (3 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}} | {{ReadWriteMemory}} | ||
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
| Parameter | Type | Description |
|---|---|---|
| String | String | 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 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
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
| Lua |
| Script Engine |
Related Functions
| Read Functions |
|---|
| readBytes |
| readSmallInteger |
| readInteger |
| readQword |
| readPointer |
| readFloat |
| readDouble |
| readString |
| Read Functions (Local Process) |
| readBytesLocal |
| readIntegerLocal |
| readQwordLocal |
| readPointerLocal |
| readFloatLocal |
| readDoubleLocal |
| readStringLocal |
| Write Functions |
| writeBytes |
| writeSmallInteger |
| writeInteger |
| writeQword |
| writeFloat |
| writeDouble |
| writeString |
| Write Functions (Local Process) |
| writeBytesLocal |
| writeIntegerLocal |
| writeQwordLocal |
| writeFloatLocal |
| writeDoubleLocal |
| writeStringLocal |
| Byte Table Conversions (Value → Byte Table) |
| wordToByteTable |
| dwordToByteTable |
| qwordToByteTable |
| floatToByteTable |
| doubleToByteTable |
| stringToByteTable |
| wideStringToByteTable |
| Byte Table Conversions (Byte Table → Value) |
| byteTableToWord |
| byteTableToDword |
| byteTableToQword |
| byteTableToFloat |
| byteTableToDouble |
| byteTableToString |
| byteTableToWideString |
