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