src/script/lua_api/l_internal.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 /******************************************************************************/
  21 /******************************************************************************/
  22 /* WARNING!!!! do NOT add this header in any include file or any code file    */
  23 /*             not being a modapi file!!!!!!!!                                */
  24 /******************************************************************************/
  25 /******************************************************************************/
  26
  27 #pragma once
  28
  29 #include "common/c_internal.h"
  30
  31 #define luamethod(class, name) {#name, class::l_##name}
  32 #define luamethod_aliased(class, name, alias) {#name, class::l_##name}, {#alias, class::l_##name}
  33 #define API_FCT(name) registerFunction(L, #name, l_##name, top)
  34
  35 // For future use
  36 #define MAP_LOCK_REQUIRED ((void)0)
  37 #define NO_MAP_LOCK_REQUIRED ((void)0)
  38
  39 /* In debug mode ensure no code tries to retrieve the server env when it isn't
  40  * actually available (in CSM) */
  41 #if !defined(SERVER) && !defined(NDEBUG)
  42 #define DEBUG_ASSERT_NO_CLIENTAPI                    \
  43         FATAL_ERROR_IF(getClient(L) != nullptr, "Tried " \
  44                 "to retrieve ServerEnvironment on client")
  45 #else
  46 #define DEBUG_ASSERT_NO_CLIENTAPI ((void)0)
  47 #endif
  48
  49 // Retrieve ServerEnvironment pointer as `env` (no map lock)
  50 #define GET_ENV_PTR_NO_MAP_LOCK                              \
  51         DEBUG_ASSERT_NO_CLIENTAPI;                               \
  52         ServerEnvironment *env = (ServerEnvironment *)getEnv(L); \
  53         if (env == NULL)                                         \
  54                 return 0
  55
  56 // Retrieve ServerEnvironment pointer as `env`
  57 #define GET_ENV_PTR         \
  58         MAP_LOCK_REQUIRED;      \
  59         GET_ENV_PTR_NO_MAP_LOCK
  60
  61 // Retrieve Environment pointer as `env` (no map lock)
  62 #define GET_PLAIN_ENV_PTR_NO_MAP_LOCK            \
  63         Environment *env = (Environment *)getEnv(L); \
  64         if (env == NULL)                             \
  65                 return 0
  66
  67 // Retrieve Environment pointer as `env`
  68 #define GET_PLAIN_ENV_PTR         \
  69         MAP_LOCK_REQUIRED;            \
  70         GET_PLAIN_ENV_PTR_NO_MAP_LOCK