luaconf.h 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813
  1. /*
  2. ** $Id: luaconf.h $
  3. ** Configuration file for Lua
  4. ** See Copyright Notice in lua.h
  5. */
  6. #ifndef luaconf_h
  7. #define luaconf_h
  8. #include <limits.h>
  9. #include <stddef.h>
  10. /*
  11. ** ===================================================================
  12. ** General Configuration File for Lua
  13. **
  14. ** Some definitions here can be changed externally, through the compiler
  15. ** (e.g., with '-D' options): They are commented out or protected
  16. ** by '#if !defined' guards. However, several other definitions
  17. ** should be changed directly here, either because they affect the
  18. ** Lua ABI (by making the changes here, you ensure that all software
  19. ** connected to Lua, such as C libraries, will be compiled with the same
  20. ** configuration); or because they are seldom changed.
  21. **
  22. ** Search for "@@" to find all configurable definitions.
  23. ** ===================================================================
  24. */
  25. /*
  26. ** {====================================================================
  27. ** System Configuration: macros to adapt (if needed) Lua to some
  28. ** particular platform, for instance restricting it to C89.
  29. ** =====================================================================
  30. */
  31. /*
  32. @@ LUA_USE_C89 controls the use of non-ISO-C89 features.
  33. ** Define it if you want Lua to avoid the use of a few C99 features
  34. ** or Windows-specific features on Windows.
  35. */
  36. /* #define LUA_USE_C89 */
  37. /*
  38. ** By default, Lua on Windows use (some) specific Windows features
  39. */
  40. #if !defined(LUA_USE_C89) && defined(_WIN32) && !defined(_WIN32_WCE)
  41. #define LUA_USE_WINDOWS /* enable goodies for regular Windows */
  42. #endif
  43. #if defined(LUA_USE_WINDOWS)
  44. #define LUA_DL_DLL /* enable support for DLL */
  45. #define LUA_USE_C89 /* broadly, Windows is C89 */
  46. #endif
  47. /*
  48. ** When POSIX DLL ('LUA_USE_DLOPEN') is enabled, the Lua stand-alone
  49. ** application will try to dynamically link a 'readline' facility
  50. ** for its REPL. In that case, LUA_READLINELIB is the name of the
  51. ** library it will look for those facilities. If lua.c cannot open
  52. ** the specified library, it will generate a warning and then run
  53. ** without 'readline'. If that macro is not defined, lua.c will not
  54. ** use 'readline'.
  55. */
  56. #if defined(LUA_USE_LINUX)
  57. #define LUA_USE_POSIX
  58. #define LUA_USE_DLOPEN /* needs an extra library: -ldl */
  59. #define LUA_READLINELIB "libreadline.so"
  60. #endif
  61. #if defined(LUA_USE_MACOSX)
  62. #define LUA_USE_POSIX
  63. #define LUA_USE_DLOPEN /* macOS does not need -ldl */
  64. #define LUA_READLINELIB "libedit.dylib"
  65. #endif
  66. #if defined(LUA_USE_IOS)
  67. #define LUA_USE_POSIX
  68. #define LUA_USE_DLOPEN
  69. #endif
  70. #if defined(LUA_USE_C89) && defined(LUA_USE_POSIX)
  71. #error "POSIX is not compatible with C89"
  72. #endif
  73. /*
  74. @@ LUAI_IS32INT is true iff 'int' has (at least) 32 bits.
  75. */
  76. #define LUAI_IS32INT ((UINT_MAX >> 30) >= 3)
  77. /* }================================================================== */
  78. /*
  79. ** {==================================================================
  80. ** Configuration for Number types. These options should not be
  81. ** set externally, because any other code connected to Lua must
  82. ** use the same configuration.
  83. ** ===================================================================
  84. */
  85. /*
  86. @@ LUA_INT_TYPE defines the type for Lua integers.
  87. @@ LUA_FLOAT_TYPE defines the type for Lua floats.
  88. ** Lua should work fine with any mix of these options supported
  89. ** by your C compiler. The usual configurations are 64-bit integers
  90. ** and 'double' (the default), 32-bit integers and 'float' (for
  91. ** restricted platforms), and 'long'/'double' (for C compilers not
  92. ** compliant with C99, which may not have support for 'long long').
  93. */
  94. /* predefined options for LUA_INT_TYPE */
  95. #define LUA_INT_INT 1
  96. #define LUA_INT_LONG 2
  97. #define LUA_INT_LONGLONG 3
  98. /* predefined options for LUA_FLOAT_TYPE */
  99. #define LUA_FLOAT_FLOAT 1
  100. #define LUA_FLOAT_DOUBLE 2
  101. #define LUA_FLOAT_LONGDOUBLE 3
  102. /* Default configuration ('long long' and 'double', for 64-bit Lua) */
  103. #define LUA_INT_DEFAULT LUA_INT_LONGLONG
  104. #define LUA_FLOAT_DEFAULT LUA_FLOAT_DOUBLE
  105. /*
  106. @@ LUA_32BITS enables Lua with 32-bit integers and 32-bit floats.
  107. */
  108. #define LUA_32BITS 0
  109. /*
  110. @@ LUA_C89_NUMBERS ensures that Lua uses the largest types available for
  111. ** C89 ('long' and 'double'); Windows always has '__int64', so it does
  112. ** not need to use this case.
  113. */
  114. #if defined(LUA_USE_C89) && !defined(LUA_USE_WINDOWS)
  115. #define LUA_C89_NUMBERS 1
  116. #else
  117. #define LUA_C89_NUMBERS 0
  118. #endif
  119. #if LUA_32BITS /* { */
  120. /*
  121. ** 32-bit integers and 'float'
  122. */
  123. #if LUAI_IS32INT /* use 'int' if big enough */
  124. #define LUA_INT_TYPE LUA_INT_INT
  125. #else /* otherwise use 'long' */
  126. #define LUA_INT_TYPE LUA_INT_LONG
  127. #endif
  128. #define LUA_FLOAT_TYPE LUA_FLOAT_FLOAT
  129. #elif LUA_C89_NUMBERS /* }{ */
  130. /*
  131. ** largest types available for C89 ('long' and 'double')
  132. */
  133. #define LUA_INT_TYPE LUA_INT_LONG
  134. #define LUA_FLOAT_TYPE LUA_FLOAT_DOUBLE
  135. #else /* }{ */
  136. /* use defaults */
  137. #define LUA_INT_TYPE LUA_INT_DEFAULT
  138. #define LUA_FLOAT_TYPE LUA_FLOAT_DEFAULT
  139. #endif /* } */
  140. /* }================================================================== */
  141. /*
  142. ** {==================================================================
  143. ** Configuration for Paths.
  144. ** ===================================================================
  145. */
  146. /*
  147. ** LUA_PATH_SEP is the character that separates templates in a path.
  148. ** LUA_PATH_MARK is the string that marks the substitution points in a
  149. ** template.
  150. ** LUA_EXEC_DIR in a Windows path is replaced by the executable's
  151. ** directory.
  152. */
  153. #define LUA_PATH_SEP ";"
  154. #define LUA_PATH_MARK "?"
  155. #define LUA_EXEC_DIR "!"
  156. /*
  157. @@ LUA_PATH_DEFAULT is the default path that Lua uses to look for
  158. ** Lua libraries.
  159. @@ LUA_CPATH_DEFAULT is the default path that Lua uses to look for
  160. ** C libraries.
  161. ** CHANGE them if your machine has a non-conventional directory
  162. ** hierarchy or if you want to install your libraries in
  163. ** non-conventional directories.
  164. */
  165. #define LUA_VDIR LUA_VERSION_MAJOR "." LUA_VERSION_MINOR
  166. #if defined(_WIN32) /* { */
  167. /*
  168. ** In Windows, any exclamation mark ('!') in the path is replaced by the
  169. ** path of the directory of the executable file of the current process.
  170. */
  171. #define LUA_LDIR "!\\lua\\"
  172. #define LUA_CDIR "!\\"
  173. #define LUA_SHRDIR "!\\..\\share\\lua\\" LUA_VDIR "\\"
  174. #if !defined(LUA_PATH_DEFAULT)
  175. #define LUA_PATH_DEFAULT \
  176. LUA_LDIR"?.lua;" LUA_LDIR"?\\init.lua;" \
  177. LUA_CDIR"?.lua;" LUA_CDIR"?\\init.lua;" \
  178. LUA_SHRDIR"?.lua;" LUA_SHRDIR"?\\init.lua;" \
  179. ".\\?.lua;" ".\\?\\init.lua"
  180. #endif
  181. #if !defined(LUA_CPATH_DEFAULT)
  182. #define LUA_CPATH_DEFAULT \
  183. LUA_CDIR"?.dll;" \
  184. LUA_CDIR"..\\lib\\lua\\" LUA_VDIR "\\?.dll;" \
  185. LUA_CDIR"loadall.dll;" ".\\?.dll"
  186. #endif
  187. #else /* }{ */
  188. #define LUA_ROOT "/usr/local/"
  189. #define LUA_LDIR LUA_ROOT "share/lua/" LUA_VDIR "/"
  190. #define LUA_CDIR LUA_ROOT "lib/lua/" LUA_VDIR "/"
  191. #if !defined(LUA_PATH_DEFAULT)
  192. #define LUA_PATH_DEFAULT \
  193. LUA_LDIR"?.lua;" LUA_LDIR"?/init.lua;" \
  194. LUA_CDIR"?.lua;" LUA_CDIR"?/init.lua;" \
  195. "./?.lua;" "./?/init.lua"
  196. #endif
  197. #if !defined(LUA_CPATH_DEFAULT)
  198. #define LUA_CPATH_DEFAULT \
  199. LUA_CDIR"?.so;" LUA_CDIR"loadall.so;" "./?.so"
  200. #endif
  201. #endif /* } */
  202. /*
  203. @@ LUA_DIRSEP is the directory separator (for submodules).
  204. ** CHANGE it if your machine does not use "/" as the directory separator
  205. ** and is not Windows. (On Windows Lua automatically uses "\".)
  206. */
  207. #if !defined(LUA_DIRSEP)
  208. #if defined(_WIN32)
  209. #define LUA_DIRSEP "\\"
  210. #else
  211. #define LUA_DIRSEP "/"
  212. #endif
  213. #endif
  214. /*
  215. ** LUA_IGMARK is a mark to ignore all after it when building the
  216. ** module name (e.g., used to build the luaopen_ function name).
  217. ** Typically, the suffix after the mark is the module version,
  218. ** as in "mod-v1.2.so".
  219. */
  220. #define LUA_IGMARK "-"
  221. /* }================================================================== */
  222. /*
  223. ** {==================================================================
  224. ** Marks for exported symbols in the C code
  225. ** ===================================================================
  226. */
  227. /*
  228. @@ LUA_API is a mark for all core API functions.
  229. @@ LUALIB_API is a mark for all auxiliary library functions.
  230. @@ LUAMOD_API is a mark for all standard library opening functions.
  231. ** CHANGE them if you need to define those functions in some special way.
  232. ** For instance, if you want to create one Windows DLL with the core and
  233. ** the libraries, you may want to use the following definition (define
  234. ** LUA_BUILD_AS_DLL to get it).
  235. */
  236. #if defined(LUA_BUILD_AS_DLL) /* { */
  237. #if defined(LUA_CORE) || defined(LUA_LIB) /* { */
  238. #define LUA_API __declspec(dllexport)
  239. #else /* }{ */
  240. #define LUA_API __declspec(dllimport)
  241. #endif /* } */
  242. #else /* }{ */
  243. #define LUA_API extern
  244. #endif /* } */
  245. /*
  246. ** More often than not the libs go together with the core.
  247. */
  248. #define LUALIB_API LUA_API
  249. #define LUAMOD_API LUA_API
  250. /*
  251. @@ LUAI_FUNC is a mark for all extern functions that are not to be
  252. ** exported to outside modules.
  253. @@ LUAI_DDEF and LUAI_DDEC are marks for all extern (const) variables,
  254. ** none of which to be exported to outside modules (LUAI_DDEF for
  255. ** definitions and LUAI_DDEC for declarations).
  256. ** CHANGE them if you need to mark them in some special way. Elf/gcc
  257. ** (versions 3.2 and later) mark them as "hidden" to optimize access
  258. ** when Lua is compiled as a shared library. Not all elf targets support
  259. ** this attribute. Unfortunately, gcc does not offer a way to check
  260. ** whether the target offers that support, and those without support
  261. ** give a warning about it. To avoid these warnings, change to the
  262. ** default definition.
  263. */
  264. #if defined(__GNUC__) && ((__GNUC__*100 + __GNUC_MINOR__) >= 302) && \
  265. defined(__ELF__) /* { */
  266. #define LUAI_FUNC __attribute__((visibility("internal"))) extern
  267. #else /* }{ */
  268. #define LUAI_FUNC extern
  269. #endif /* } */
  270. #define LUAI_DDEC(dec) LUAI_FUNC dec
  271. #define LUAI_DDEF /* empty */
  272. /* }================================================================== */
  273. /*
  274. ** {==================================================================
  275. ** Compatibility with previous versions
  276. ** ===================================================================
  277. */
  278. /*
  279. @@ LUA_COMPAT_GLOBAL avoids 'global' being a reserved word
  280. */
  281. #define LUA_COMPAT_GLOBAL
  282. /*
  283. @@ LUA_COMPAT_5_3 controls other macros for compatibility with Lua 5.3.
  284. ** You can define it to get all options, or change specific options
  285. ** to fit your specific needs.
  286. */
  287. #if defined(LUA_COMPAT_5_3) /* { */
  288. /*
  289. @@ LUA_COMPAT_MATHLIB controls the presence of several deprecated
  290. ** functions in the mathematical library.
  291. ** (These functions were already officially removed in 5.3;
  292. ** nevertheless they are still available here.)
  293. */
  294. #define LUA_COMPAT_MATHLIB
  295. /*
  296. @@ LUA_COMPAT_APIINTCASTS controls the presence of macros for
  297. ** manipulating other integer types (lua_pushunsigned, lua_tounsigned,
  298. ** luaL_checkint, luaL_checklong, etc.)
  299. ** (These macros were also officially removed in 5.3, but they are still
  300. ** available here.)
  301. */
  302. #define LUA_COMPAT_APIINTCASTS
  303. /*
  304. @@ LUA_COMPAT_LT_LE controls the emulation of the '__le' metamethod
  305. ** using '__lt'.
  306. */
  307. #define LUA_COMPAT_LT_LE
  308. /*
  309. @@ The following macros supply trivial compatibility for some
  310. ** changes in the API. The macros themselves document how to
  311. ** change your code to avoid using them.
  312. ** (Once more, these macros were officially removed in 5.3, but they are
  313. ** still available here.)
  314. */
  315. #define lua_strlen(L,i) lua_rawlen(L, (i))
  316. #define lua_objlen(L,i) lua_rawlen(L, (i))
  317. #define lua_equal(L,idx1,idx2) lua_compare(L,(idx1),(idx2),LUA_OPEQ)
  318. #define lua_lessthan(L,idx1,idx2) lua_compare(L,(idx1),(idx2),LUA_OPLT)
  319. #endif /* } */
  320. /* }================================================================== */
  321. /*
  322. ** {==================================================================
  323. ** Configuration for Numbers (low-level part).
  324. ** Change these definitions if no predefined LUA_FLOAT_* / LUA_INT_*
  325. ** satisfy your needs.
  326. ** ===================================================================
  327. */
  328. /*
  329. @@ LUAI_UACNUMBER is the result of a 'default argument promotion'
  330. @@ over a floating number.
  331. @@ l_floatatt(x) corrects float attribute 'x' to the proper float type
  332. ** by prefixing it with one of FLT/DBL/LDBL.
  333. @@ LUA_NUMBER_FRMLEN is the length modifier for writing floats.
  334. @@ LUA_NUMBER_FMT is the format for writing floats with the maximum
  335. ** number of digits that respects tostring(tonumber(numeral)) == numeral.
  336. ** (That would be floor(log10(2^n)), where n is the number of bits in
  337. ** the float mantissa.)
  338. @@ LUA_NUMBER_FMT_N is the format for writing floats with the minimum
  339. ** number of digits that ensures tonumber(tostring(number)) == number.
  340. ** (That would be LUA_NUMBER_FMT+2.)
  341. @@ l_mathop allows the addition of an 'l' or 'f' to all math operations.
  342. @@ l_floor takes the floor of a float.
  343. @@ lua_str2number converts a decimal numeral to a number.
  344. */
  345. /* The following definitions are good for most cases here */
  346. #define l_floor(x) (l_mathop(floor)(x))
  347. /*
  348. @@ lua_numbertointeger converts a float number with an integral value
  349. ** to an integer, or returns 0 if float is not within the range of
  350. ** a lua_Integer. (The range comparisons are tricky because of
  351. ** rounding. The tests here assume a two-complement representation,
  352. ** where MININTEGER always has an exact representation as a float;
  353. ** MAXINTEGER may not have one, and therefore its conversion to float
  354. ** may have an ill-defined value.)
  355. */
  356. #define lua_numbertointeger(n,p) \
  357. ((n) >= (LUA_NUMBER)(LUA_MININTEGER) && \
  358. (n) < -(LUA_NUMBER)(LUA_MININTEGER) && \
  359. (*(p) = (LUA_INTEGER)(n), 1))
  360. /* now the variable definitions */
  361. #if LUA_FLOAT_TYPE == LUA_FLOAT_FLOAT /* { single float */
  362. #define LUA_NUMBER float
  363. #define l_floatatt(n) (FLT_##n)
  364. #define LUAI_UACNUMBER double
  365. #define LUA_NUMBER_FRMLEN ""
  366. #define LUA_NUMBER_FMT "%.7g"
  367. #define LUA_NUMBER_FMT_N "%.9g"
  368. #define l_mathop(op) op##f
  369. #define lua_str2number(s,p) strtof((s), (p))
  370. #elif LUA_FLOAT_TYPE == LUA_FLOAT_LONGDOUBLE /* }{ long double */
  371. #define LUA_NUMBER long double
  372. #define l_floatatt(n) (LDBL_##n)
  373. #define LUAI_UACNUMBER long double
  374. #define LUA_NUMBER_FRMLEN "L"
  375. #define LUA_NUMBER_FMT "%.19Lg"
  376. #define LUA_NUMBER_FMT_N "%.21Lg"
  377. #define l_mathop(op) op##l
  378. #define lua_str2number(s,p) strtold((s), (p))
  379. #elif LUA_FLOAT_TYPE == LUA_FLOAT_DOUBLE /* }{ double */
  380. #define LUA_NUMBER double
  381. #define l_floatatt(n) (DBL_##n)
  382. #define LUAI_UACNUMBER double
  383. #define LUA_NUMBER_FRMLEN ""
  384. #define LUA_NUMBER_FMT "%.15g"
  385. #define LUA_NUMBER_FMT_N "%.17g"
  386. #define l_mathop(op) op
  387. #define lua_str2number(s,p) strtod((s), (p))
  388. #else /* }{ */
  389. #error "numeric float type not defined"
  390. #endif /* } */
  391. /*
  392. @@ LUA_UNSIGNED is the unsigned version of LUA_INTEGER.
  393. @@ LUAI_UACINT is the result of a 'default argument promotion'
  394. @@ over a LUA_INTEGER.
  395. @@ LUA_INTEGER_FRMLEN is the length modifier for reading/writing integers.
  396. @@ LUA_INTEGER_FMT is the format for writing integers.
  397. @@ LUA_MAXINTEGER is the maximum value for a LUA_INTEGER.
  398. @@ LUA_MININTEGER is the minimum value for a LUA_INTEGER.
  399. @@ LUA_MAXUNSIGNED is the maximum value for a LUA_UNSIGNED.
  400. @@ lua_integer2str converts an integer to a string.
  401. */
  402. /* The following definitions are good for most cases here */
  403. #define LUA_INTEGER_FMT "%" LUA_INTEGER_FRMLEN "d"
  404. #define LUAI_UACINT LUA_INTEGER
  405. #define lua_integer2str(s,sz,n) \
  406. l_sprintf((s), sz, LUA_INTEGER_FMT, (LUAI_UACINT)(n))
  407. /*
  408. ** use LUAI_UACINT here to avoid problems with promotions (which
  409. ** can turn a comparison between unsigneds into a signed comparison)
  410. */
  411. #define LUA_UNSIGNED unsigned LUAI_UACINT
  412. /* now the variable definitions */
  413. #if LUA_INT_TYPE == LUA_INT_INT /* { int */
  414. #define LUA_INTEGER int
  415. #define LUA_INTEGER_FRMLEN ""
  416. #define LUA_MAXINTEGER INT_MAX
  417. #define LUA_MININTEGER INT_MIN
  418. #define LUA_MAXUNSIGNED UINT_MAX
  419. #elif LUA_INT_TYPE == LUA_INT_LONG /* }{ long */
  420. #define LUA_INTEGER long
  421. #define LUA_INTEGER_FRMLEN "l"
  422. #define LUA_MAXINTEGER LONG_MAX
  423. #define LUA_MININTEGER LONG_MIN
  424. #define LUA_MAXUNSIGNED ULONG_MAX
  425. #elif LUA_INT_TYPE == LUA_INT_LONGLONG /* }{ long long */
  426. /* use presence of macro LLONG_MAX as proxy for C99 compliance */
  427. #if defined(LLONG_MAX) /* { */
  428. /* use ISO C99 stuff */
  429. #define LUA_INTEGER long long
  430. #define LUA_INTEGER_FRMLEN "ll"
  431. #define LUA_MAXINTEGER LLONG_MAX
  432. #define LUA_MININTEGER LLONG_MIN
  433. #define LUA_MAXUNSIGNED ULLONG_MAX
  434. #elif defined(LUA_USE_WINDOWS) /* }{ */
  435. /* in Windows, can use specific Windows types */
  436. #define LUA_INTEGER __int64
  437. #define LUA_INTEGER_FRMLEN "I64"
  438. #define LUA_MAXINTEGER _I64_MAX
  439. #define LUA_MININTEGER _I64_MIN
  440. #define LUA_MAXUNSIGNED _UI64_MAX
  441. #else /* }{ */
  442. #error "Compiler does not support 'long long'. Use option '-DLUA_32BITS' \
  443. or '-DLUA_C89_NUMBERS' (see file 'luaconf.h' for details)"
  444. #endif /* } */
  445. #else /* }{ */
  446. #error "numeric integer type not defined"
  447. #endif /* } */
  448. /* }================================================================== */
  449. /*
  450. ** {==================================================================
  451. ** Dependencies with C99 and other C details
  452. ** ===================================================================
  453. */
  454. /*
  455. @@ l_sprintf is equivalent to 'snprintf' or 'sprintf' in C89.
  456. ** (All uses in Lua have only one format item.)
  457. */
  458. #if !defined(LUA_USE_C89)
  459. #define l_sprintf(s,sz,f,i) snprintf(s,sz,f,i)
  460. #else
  461. #define l_sprintf(s,sz,f,i) ((void)(sz), sprintf(s,f,i))
  462. #endif
  463. /*
  464. @@ lua_strx2number converts a hexadecimal numeral to a number.
  465. ** In C99, 'strtod' does that conversion. Otherwise, you can
  466. ** leave 'lua_strx2number' undefined and Lua will provide its own
  467. ** implementation.
  468. */
  469. #if !defined(LUA_USE_C89)
  470. #define lua_strx2number(s,p) lua_str2number(s,p)
  471. #endif
  472. /*
  473. @@ lua_pointer2str converts a pointer to a readable string in a
  474. ** non-specified way.
  475. */
  476. #define lua_pointer2str(buff,sz,p) l_sprintf(buff,sz,"%p",p)
  477. /*
  478. @@ lua_number2strx converts a float to a hexadecimal numeral.
  479. ** In C99, 'sprintf' (with format specifiers '%a'/'%A') does that.
  480. ** Otherwise, you can leave 'lua_number2strx' undefined and Lua will
  481. ** provide its own implementation.
  482. */
  483. #if !defined(LUA_USE_C89)
  484. #define lua_number2strx(L,b,sz,f,n) \
  485. ((void)L, l_sprintf(b,sz,f,(LUAI_UACNUMBER)(n)))
  486. #endif
  487. /*
  488. ** 'strtof' and 'opf' variants for math functions are not valid in
  489. ** C89. Otherwise, the macro 'HUGE_VALF' is a good proxy for testing the
  490. ** availability of these variants. ('math.h' is already included in
  491. ** all files that use these macros.)
  492. */
  493. #if defined(LUA_USE_C89) || (defined(HUGE_VAL) && !defined(HUGE_VALF))
  494. #undef l_mathop /* variants not available */
  495. #undef lua_str2number
  496. #define l_mathop(op) (lua_Number)op /* no variant */
  497. #define lua_str2number(s,p) ((lua_Number)strtod((s), (p)))
  498. #endif
  499. /*
  500. @@ LUA_KCONTEXT is the type of the context ('ctx') for continuation
  501. ** functions. It must be a numerical type; Lua will use 'intptr_t' if
  502. ** available, otherwise it will use 'ptrdiff_t' (the nearest thing to
  503. ** 'intptr_t' in C89)
  504. */
  505. #define LUA_KCONTEXT ptrdiff_t
  506. #if !defined(LUA_USE_C89) && defined(__STDC_VERSION__) && \
  507. __STDC_VERSION__ >= 199901L
  508. #include <stdint.h>
  509. #if defined(INTPTR_MAX) /* even in C99 this type is optional */
  510. #undef LUA_KCONTEXT
  511. #define LUA_KCONTEXT intptr_t
  512. #endif
  513. #endif
  514. /*
  515. @@ lua_getlocaledecpoint gets the locale "radix character" (decimal point).
  516. ** Change that if you do not want to use C locales. (Code using this
  517. ** macro must include the header 'locale.h'.)
  518. */
  519. #if !defined(lua_getlocaledecpoint)
  520. #define lua_getlocaledecpoint() (localeconv()->decimal_point[0])
  521. #endif
  522. /*
  523. ** macros to improve jump prediction, used mostly for error handling
  524. ** and debug facilities. (Some macros in the Lua API use these macros.
  525. ** Define LUA_NOBUILTIN if you do not want '__builtin_expect' in your
  526. ** code.)
  527. */
  528. #if !defined(luai_likely)
  529. #if defined(__GNUC__) && !defined(LUA_NOBUILTIN)
  530. #define luai_likely(x) (__builtin_expect(((x) != 0), 1))
  531. #define luai_unlikely(x) (__builtin_expect(((x) != 0), 0))
  532. #else
  533. #define luai_likely(x) (x)
  534. #define luai_unlikely(x) (x)
  535. #endif
  536. #endif
  537. #if defined(LUA_CORE) || defined(LUA_LIB)
  538. /* shorter names for Lua's own use */
  539. #define l_likely(x) luai_likely(x)
  540. #define l_unlikely(x) luai_unlikely(x)
  541. #endif
  542. /* }================================================================== */
  543. /*
  544. ** {==================================================================
  545. ** Language Variations
  546. ** =====================================================================
  547. */
  548. /*
  549. @@ LUA_NOCVTN2S/LUA_NOCVTS2N control how Lua performs some
  550. ** coercions. Define LUA_NOCVTN2S to turn off automatic coercion from
  551. ** numbers to strings. Define LUA_NOCVTS2N to turn off automatic
  552. ** coercion from strings to numbers.
  553. */
  554. /* #define LUA_NOCVTN2S */
  555. /* #define LUA_NOCVTS2N */
  556. /*
  557. @@ LUA_USE_APICHECK turns on several consistency checks on the C API.
  558. ** Define it as a help when debugging C code.
  559. */
  560. /* #define LUA_USE_APICHECK */
  561. /* }================================================================== */
  562. /*
  563. ** {==================================================================
  564. ** Macros that affect the API and must be stable (that is, must be the
  565. ** same when you compile Lua and when you compile code that links to
  566. ** Lua).
  567. ** =====================================================================
  568. */
  569. /*
  570. @@ LUA_EXTRASPACE defines the size of a raw memory area associated with
  571. ** a Lua state with very fast access.
  572. ** CHANGE it if you need a different size.
  573. */
  574. #define LUA_EXTRASPACE (sizeof(void *))
  575. /*
  576. @@ LUA_IDSIZE gives the maximum size for the description of the source
  577. ** of a function in debug information.
  578. ** CHANGE it if you want a different size.
  579. */
  580. #define LUA_IDSIZE 60
  581. /*
  582. @@ LUAL_BUFFERSIZE is the initial buffer size used by the lauxlib
  583. ** buffer system.
  584. */
  585. #define LUAL_BUFFERSIZE ((int)(16 * sizeof(void*) * sizeof(lua_Number)))
  586. /*
  587. @@ LUAI_MAXALIGN defines fields that, when used in a union, ensure
  588. ** maximum alignment for the other items in that union.
  589. */
  590. #define LUAI_MAXALIGN lua_Number n; double u; void *s; lua_Integer i; long l
  591. /* }================================================================== */
  592. /* =================================================================== */
  593. /*
  594. ** Local configuration. You can use this space to add your redefinitions
  595. ** without modifying the main part of the file.
  596. */
  597. #endif