Difference between revisions of "Package.loadlib"

From GiderosMobile
(Created page with "__NOTOC__ '''Available since:''' Gideros 2011.6<br/> === Description === Dynamically links the host program with the C library libname. Inside this library, looks for a functi...")
 
Line 10: Line 10:
 
  This function is not supported by ANSI C. As such, it is only available on some platforms (Windows, Linux, Mac OS X, Solaris, BSD, plus other Unix systems that support the dlfcn standard).
 
  This function is not supported by ANSI C. As such, it is only available on some platforms (Windows, Linux, Mac OS X, Solaris, BSD, plus other Unix systems that support the dlfcn standard).
 
<source lang="lua">
 
<source lang="lua">
= package.loadlib(libnamefuncname,)
+
package.loadlib(libname,funcname)
 
</source>
 
</source>
'''libname:''' (string) name of the library to load ''''''<br/>
+
'''libname''': (string) name of the library to load ''''''<br/>
'''funcname:''' (string) name of the function in library ''''''<br/>
+
'''funcname''': (string) name of the function in library ''''''<br/>

Revision as of 11:16, 23 August 2018

Available since: Gideros 2011.6

Description

Dynamically links the host program with the C library libname. Inside this library, looks for a function funcname and returns this function as a C function. (So, funcname must follow the protocol (see lua_CFunction)).


This is a low-level function. It completely bypasses the package and module system. Unlike require, it does not perform any path searching and does not automatically adds extensions. libname must be the complete file name of the C library, including if necessary a path and extension. funcname must be the exact name exported by the C library (which may depend on the C compiler and linker used). 


This function is not supported by ANSI C. As such, it is only available on some platforms (Windows, Linux, Mac OS X, Solaris, BSD, plus other Unix systems that support the dlfcn standard).
 package.loadlib(libname,funcname)

'libname: (string) name of the library to load '
'funcname: (string) name of the function in library '