love.data.unpack
Available since LÖVE 11.0
This function is not supported in earlier versions.
Unpacks (deserializes) a byte-string or Data into simple Lua values.
This function behaves the same as Lua 5.3's string.unpack.
Function
Synopsis
v1, ..., index = love.data.unpack( format, datastring, pos )Arguments
-
string format - A string determining how the values were packed. Follows the rules of Lua 5.3's string.pack format strings.
-
string datastring - A string containing the packed (serialized) data.
-
number pos (1) - Where to start reading in the string. Negative values can be used to read relative from the end of the string.
Returns
-
value v1 - The first value (number, boolean, or string) that was unpacked.
-
value ... - Additional unpacked values.
-
number index - The index of the first unread byte in the data string.
Function
Synopsis
v1, ..., index = love.data.unpack( format, data, pos )Arguments
-
string format - A string determining how the values were packed. Follows the rules of Lua 5.3's string.pack format strings.
-
Data data - A Data object containing the packed (serialized) data.
-
number pos (1) - 1-based index indicating where to start reading in the Data. Negative values can be used to read relative from the end of the Data object.
Returns
-
value v1 - The first value (number, boolean, or string) that was unpacked.
-
value ... - Additional unpacked values.
-
number index - The 1-based index of the first unread byte in the Data.
Notes
Unpacking integers with values greater than 2^52 is not supported, as Lua 5.1 cannot represent those values in its number type.
See Also
© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/love.data.unpack