{{newin|[[11.0]]|110|type=function}}
Unpacks (deserializes) a byte-string or Data into simple Lua values.

This function behaves the same as Lua 5.3's [https://www.lua.org/manual/5.3/manual.html#pdf-string.unpack string.unpack].
 
== Function ==
=== Synopsis ===
<source lang="lua">
v1, ..., index = love.data.unpack( format, datastring, pos )
</source>
=== Arguments ===
{{param|string|format|A string determining how the values were packed. Follows the rules of [https://www.lua.org/manual/5.3/manual.html#6.4.2 Lua 5.3's string.pack format strings].}}
{{param|string|datastring|A string containing the packed (serialized) data.}}
{{param|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 ===
{{param|value|v1|The first value (number, boolean, or string) that was unpacked.}}
{{param|value|...|Additional unpacked values.}}
{{param|number|index|The index of the first unread byte in the data string.}}

== Function ==
=== Synopsis ===
<source lang="lua">
v1, ..., index = love.data.unpack( format, data, pos )
</source>
=== Arguments ===
{{param|string|format|A string determining how the values were packed. Follows the rules of [https://www.lua.org/manual/5.3/manual.html#6.4.2 Lua 5.3's string.pack format strings].}}
{{param|Data|data|A Data object containing the packed (serialized) data.}}
{{param|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 ===
{{param|value|v1|The first value (number, boolean, or string) that was unpacked.}}
{{param|value|...|Additional unpacked values.}}
{{param|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 ==
* [[parent::love.data]]
* [[love.data.pack]]
* [[love.data.getPackedSize]]
[[Category:Functions]]
{{#set:Description=Unpacks (deserializes) a byte-string or Data into simple Lua values.}}
== Other Languages ==
{{i18n|love.data.unpack}}