llimits.h 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381
  1. /*
  2. ** $Id: llimits.h $
  3. ** Limits, basic types, and some other 'installation-dependent' definitions
  4. ** See Copyright Notice in lua.h
  5. */
  6. #ifndef llimits_h
  7. #define llimits_h
  8. #include <limits.h>
  9. #include <stddef.h>
  10. #include "lua.h"
  11. /*
  12. ** 'lu_mem' and 'l_mem' are unsigned/signed integers big enough to count
  13. ** the total memory used by Lua (in bytes). Usually, 'size_t' and
  14. ** 'ptrdiff_t' should work, but we use 'long' for 16-bit machines.
  15. */
  16. #if defined(LUAI_MEM) /* { external definitions? */
  17. typedef LUAI_UMEM lu_mem;
  18. typedef LUAI_MEM l_mem;
  19. #elif LUAI_IS32INT /* }{ */
  20. typedef size_t lu_mem;
  21. typedef ptrdiff_t l_mem;
  22. #else /* 16-bit ints */ /* }{ */
  23. typedef unsigned long lu_mem;
  24. typedef long l_mem;
  25. #endif /* } */
  26. /* chars used as small naturals (so that 'char' is reserved for characters) */
  27. typedef unsigned char lu_byte;
  28. typedef signed char ls_byte;
  29. /* maximum value for size_t */
  30. #define MAX_SIZET ((size_t)(~(size_t)0))
  31. /* maximum size visible for Lua (must be representable in a lua_Integer) */
  32. #define MAX_SIZE (sizeof(size_t) < sizeof(lua_Integer) ? MAX_SIZET \
  33. : (size_t)(LUA_MAXINTEGER))
  34. #define MAX_LUMEM ((lu_mem)(~(lu_mem)0))
  35. #define MAX_LMEM ((l_mem)(MAX_LUMEM >> 1))
  36. #define MAX_INT INT_MAX /* maximum value of an int */
  37. /*
  38. ** floor of the log2 of the maximum signed value for integral type 't'.
  39. ** (That is, maximum 'n' such that '2^n' fits in the given signed type.)
  40. */
  41. #define log2maxs(t) (sizeof(t) * 8 - 2)
  42. /*
  43. ** test whether an unsigned value is a power of 2 (or zero)
  44. */
  45. #define ispow2(x) (((x) & ((x) - 1)) == 0)
  46. /* number of chars of a literal string without the ending \0 */
  47. #define LL(x) (sizeof(x)/sizeof(char) - 1)
  48. /*
  49. ** conversion of pointer to unsigned integer: this is for hashing only;
  50. ** there is no problem if the integer cannot hold the whole pointer
  51. ** value. (In strict ISO C this may cause undefined behavior, but no
  52. ** actual machine seems to bother.)
  53. */
  54. #if !defined(LUA_USE_C89) && defined(__STDC_VERSION__) && \
  55. __STDC_VERSION__ >= 199901L
  56. #include <stdint.h>
  57. #if defined(UINTPTR_MAX) /* even in C99 this type is optional */
  58. #define L_P2I uintptr_t
  59. #else /* no 'intptr'? */
  60. #define L_P2I uintmax_t /* use the largest available integer */
  61. #endif
  62. #else /* C89 option */
  63. #define L_P2I size_t
  64. #endif
  65. #define point2uint(p) ((unsigned int)((L_P2I)(p) & UINT_MAX))
  66. /* types of 'usual argument conversions' for lua_Number and lua_Integer */
  67. typedef LUAI_UACNUMBER l_uacNumber;
  68. typedef LUAI_UACINT l_uacInt;
  69. /*
  70. ** Internal assertions for in-house debugging
  71. */
  72. #if defined LUAI_ASSERT
  73. #undef NDEBUG
  74. #include <assert.h>
  75. #define lua_assert(c) assert(c)
  76. #endif
  77. #if defined(lua_assert)
  78. #define check_exp(c,e) (lua_assert(c), (e))
  79. /* to avoid problems with conditions too long */
  80. #define lua_longassert(c) ((c) ? (void)0 : lua_assert(0))
  81. #else
  82. #define lua_assert(c) ((void)0)
  83. #define check_exp(c,e) (e)
  84. #define lua_longassert(c) ((void)0)
  85. #endif
  86. /*
  87. ** assertion for checking API calls
  88. */
  89. #if !defined(luai_apicheck)
  90. #define luai_apicheck(l,e) ((void)l, lua_assert(e))
  91. #endif
  92. #define api_check(l,e,msg) luai_apicheck(l,(e) && msg)
  93. /* macro to avoid warnings about unused variables */
  94. #if !defined(UNUSED)
  95. #define UNUSED(x) ((void)(x))
  96. #endif
  97. /* type casts (a macro highlights casts in the code) */
  98. #define cast(t, exp) ((t)(exp))
  99. #define cast_void(i) cast(void, (i))
  100. #define cast_voidp(i) cast(void *, (i))
  101. #define cast_num(i) cast(lua_Number, (i))
  102. #define cast_int(i) cast(int, (i))
  103. #define cast_uint(i) cast(unsigned int, (i))
  104. #define cast_byte(i) cast(lu_byte, (i))
  105. #define cast_uchar(i) cast(unsigned char, (i))
  106. #define cast_char(i) cast(char, (i))
  107. #define cast_charp(i) cast(char *, (i))
  108. #define cast_sizet(i) cast(size_t, (i))
  109. /* cast a signed lua_Integer to lua_Unsigned */
  110. #if !defined(l_castS2U)
  111. #define l_castS2U(i) ((lua_Unsigned)(i))
  112. #endif
  113. /*
  114. ** cast a lua_Unsigned to a signed lua_Integer; this cast is
  115. ** not strict ISO C, but two-complement architectures should
  116. ** work fine.
  117. */
  118. #if !defined(l_castU2S)
  119. #define l_castU2S(i) ((lua_Integer)(i))
  120. #endif
  121. /*
  122. ** non-return type
  123. */
  124. #if !defined(l_noret)
  125. #if defined(__GNUC__)
  126. #define l_noret void __attribute__((noreturn))
  127. #elif defined(_MSC_VER) && _MSC_VER >= 1200
  128. #define l_noret void __declspec(noreturn)
  129. #else
  130. #define l_noret void
  131. #endif
  132. #endif
  133. /*
  134. ** Inline functions
  135. */
  136. #if !defined(LUA_USE_C89)
  137. #define l_inline inline
  138. #elif defined(__GNUC__)
  139. #define l_inline __inline__
  140. #else
  141. #define l_inline /* empty */
  142. #endif
  143. #define l_sinline static l_inline
  144. /*
  145. ** type for virtual-machine instructions;
  146. ** must be an unsigned with (at least) 4 bytes (see details in lopcodes.h)
  147. */
  148. #if LUAI_IS32INT
  149. typedef unsigned int l_uint32;
  150. #else
  151. typedef unsigned long l_uint32;
  152. #endif
  153. typedef l_uint32 Instruction;
  154. /*
  155. ** Maximum length for short strings, that is, strings that are
  156. ** internalized. (Cannot be smaller than reserved words or tags for
  157. ** metamethods, as these strings must be internalized;
  158. ** #("function") = 8, #("__newindex") = 10.)
  159. */
  160. #if !defined(LUAI_MAXSHORTLEN)
  161. #define LUAI_MAXSHORTLEN 40
  162. #endif
  163. /*
  164. ** Initial size for the string table (must be power of 2).
  165. ** The Lua core alone registers ~50 strings (reserved words +
  166. ** metaevent keys + a few others). Libraries would typically add
  167. ** a few dozens more.
  168. */
  169. #if !defined(MINSTRTABSIZE)
  170. #define MINSTRTABSIZE 128
  171. #endif
  172. /*
  173. ** Size of cache for strings in the API. 'N' is the number of
  174. ** sets (better be a prime) and "M" is the size of each set (M == 1
  175. ** makes a direct cache.)
  176. */
  177. #if !defined(STRCACHE_N)
  178. #define STRCACHE_N 53
  179. #define STRCACHE_M 2
  180. #endif
  181. /* minimum size for string buffer */
  182. #if !defined(LUA_MINBUFFER)
  183. #define LUA_MINBUFFER 32
  184. #endif
  185. /*
  186. ** Maximum depth for nested C calls, syntactical nested non-terminals,
  187. ** and other features implemented through recursion in C. (Value must
  188. ** fit in a 16-bit unsigned integer. It must also be compatible with
  189. ** the size of the C stack.)
  190. */
  191. #if !defined(LUAI_MAXCCALLS)
  192. #define LUAI_MAXCCALLS 200
  193. #endif
  194. /*
  195. ** macros that are executed whenever program enters the Lua core
  196. ** ('lua_lock') and leaves the core ('lua_unlock')
  197. */
  198. #if !defined(lua_lock)
  199. #define lua_lock(L) ((void) 0)
  200. #define lua_unlock(L) ((void) 0)
  201. #endif
  202. /*
  203. ** macro executed during Lua functions at points where the
  204. ** function can yield.
  205. */
  206. #if !defined(luai_threadyield)
  207. #define luai_threadyield(L) {lua_unlock(L); lua_lock(L);}
  208. #endif
  209. /*
  210. ** these macros allow user-specific actions when a thread is
  211. ** created/deleted/resumed/yielded.
  212. */
  213. #if !defined(luai_userstateopen)
  214. #define luai_userstateopen(L) ((void)L)
  215. #endif
  216. #if !defined(luai_userstateclose)
  217. #define luai_userstateclose(L) ((void)L)
  218. #endif
  219. #if !defined(luai_userstatethread)
  220. #define luai_userstatethread(L,L1) ((void)L)
  221. #endif
  222. #if !defined(luai_userstatefree)
  223. #define luai_userstatefree(L,L1) ((void)L)
  224. #endif
  225. #if !defined(luai_userstateresume)
  226. #define luai_userstateresume(L,n) ((void)L)
  227. #endif
  228. #if !defined(luai_userstateyield)
  229. #define luai_userstateyield(L,n) ((void)L)
  230. #endif
  231. /*
  232. ** The luai_num* macros define the primitive operations over numbers.
  233. */
  234. /* floor division (defined as 'floor(a/b)') */
  235. #if !defined(luai_numidiv)
  236. #define luai_numidiv(L,a,b) ((void)L, l_floor(luai_numdiv(L,a,b)))
  237. #endif
  238. /* float division */
  239. #if !defined(luai_numdiv)
  240. #define luai_numdiv(L,a,b) ((a)/(b))
  241. #endif
  242. /*
  243. ** modulo: defined as 'a - floor(a/b)*b'; the direct computation
  244. ** using this definition has several problems with rounding errors,
  245. ** so it is better to use 'fmod'. 'fmod' gives the result of
  246. ** 'a - trunc(a/b)*b', and therefore must be corrected when
  247. ** 'trunc(a/b) ~= floor(a/b)'. That happens when the division has a
  248. ** non-integer negative result: non-integer result is equivalent to
  249. ** a non-zero remainder 'm'; negative result is equivalent to 'a' and
  250. ** 'b' with different signs, or 'm' and 'b' with different signs
  251. ** (as the result 'm' of 'fmod' has the same sign of 'a').
  252. */
  253. #if !defined(luai_nummod)
  254. #define luai_nummod(L,a,b,m) \
  255. { (void)L; (m) = l_mathop(fmod)(a,b); \
  256. if (((m) > 0) ? (b) < 0 : ((m) < 0 && (b) > 0)) (m) += (b); }
  257. #endif
  258. /* exponentiation */
  259. #if !defined(luai_numpow)
  260. #define luai_numpow(L,a,b) \
  261. ((void)L, (b == 2) ? (a)*(a) : l_mathop(pow)(a,b))
  262. #endif
  263. /* the others are quite standard operations */
  264. #if !defined(luai_numadd)
  265. #define luai_numadd(L,a,b) ((a)+(b))
  266. #define luai_numsub(L,a,b) ((a)-(b))
  267. #define luai_nummul(L,a,b) ((a)*(b))
  268. #define luai_numunm(L,a) (-(a))
  269. #define luai_numeq(a,b) ((a)==(b))
  270. #define luai_numlt(a,b) ((a)<(b))
  271. #define luai_numle(a,b) ((a)<=(b))
  272. #define luai_numgt(a,b) ((a)>(b))
  273. #define luai_numge(a,b) ((a)>=(b))
  274. #define luai_numisnan(a) (!luai_numeq((a), (a)))
  275. #endif
  276. /*
  277. ** macro to control inclusion of some hard tests on stack reallocation
  278. */
  279. #if !defined(HARDSTACKTESTS)
  280. #define condmovestack(L,pre,pos) ((void)0)
  281. #else
  282. /* realloc stack keeping its size */
  283. #define condmovestack(L,pre,pos) \
  284. { int sz_ = stacksize(L); pre; luaD_reallocstack((L), sz_, 0); pos; }
  285. #endif
  286. #if !defined(HARDMEMTESTS)
  287. #define condchangemem(L,pre,pos) ((void)0)
  288. #else
  289. #define condchangemem(L,pre,pos) \
  290. { if (gcrunning(G(L))) { pre; luaC_fullgc(L, 0); pos; } }
  291. #endif
  292. #endif