Difference between revisions of "Data:getPointer"

m (Added notice about dangers)
m (Make LOVE in all caps.)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
Gets a pointer to the Data. Can be used with libraries such as LuaJIT's [http://luajit.org/ext_ffi.html FFI].
 
Gets a pointer to the Data. Can be used with libraries such as LuaJIT's [http://luajit.org/ext_ffi.html FFI].
 
{{notice|Use at your own risk. Directly reading from and writing to the raw memory owned by the Data will bypass any safety checks and thread-safety the Data might normally have.}}
 
{{notice|Use at your own risk. Directly reading from and writing to the raw memory owned by the Data will bypass any safety checks and thread-safety the Data might normally have.}}
 +
{{notice|Since LÖVE [[11.3]], [[Data:getFFIPointer]] is a preferred alternative because it can work with new 64-bit architectures.}}
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 14: Line 15:
 
* [[Data:getSize]]
 
* [[Data:getSize]]
 
* [[Data:getString]]
 
* [[Data:getString]]
 +
* [[Data:getFFIPointer]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Gets a pointer to the Data.}}
 
{{#set:Description=Gets a pointer to the Data.}}

Latest revision as of 13:58, 29 July 2020

Gets a pointer to the Data. Can be used with libraries such as LuaJIT's FFI.

O.png Use at your own risk. Directly reading from and writing to the raw memory owned by the Data will bypass any safety checks and thread-safety the Data might normally have.  


O.png Since LÖVE 11.3, Data:getFFIPointer is a preferred alternative because it can work with new 64-bit architectures.  


Function

Synopsis

pointer = Data:getPointer( )

Arguments

None.

Returns

light userdata pointer
A raw pointer to the Data.

See Also


Other Languages