Difference between revisions of "Data:getPointer"
(fixed wording and return) |
m (Make LOVE in all caps.) |
||
(6 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | Gets a pointer to the Data. | + | 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|Since LÖVE [[11.3]], [[Data:getFFIPointer]] is a preferred alternative because it can work with new 64-bit architectures.}} | ||
== Function == | == Function == | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
− | + | pointer = Data:getPointer( ) | |
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
None. | None. | ||
=== Returns === | === Returns === | ||
− | {{param|light userdata| | + | {{param|light userdata|pointer|A raw pointer to the Data.}} |
− | |||
== See Also == | == See Also == | ||
* [[parent::Data]] | * [[parent::Data]] | ||
+ | * [[Data:getSize]] | ||
+ | * [[Data:getString]] | ||
+ | * [[Data:getFFIPointer]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
{{#set:Description=Gets a pointer to the Data.}} | {{#set:Description=Gets a pointer to the Data.}} | ||
+ | {{#set:Since=000}} | ||
+ | == Other Languages == | ||
+ | {{i18n|Data:getPointer}} |
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.
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. |
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
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info