#ifndef ENUM_HELPER_H #define ENUM_HELPER_H #include "LuaReference.h" #include "RageUtil.h" #include #ifndef _MSC_VER extern "C" { #endif #include "../extern/lua-5.1/src/lua.h" #ifndef _MSC_VER } #endif /** @brief A general foreach loop for enumerators, going up to a max value. */ #define FOREACH_ENUM_N( e, max, var ) for( e var=(e)0; var( var, +1 ) ) /** @brief A general foreach loop for enumerators. */ #define FOREACH_ENUM( e, var ) for( e var=(e)0; var( var, +1 ) ) int CheckEnum(lua_State *L, LuaReference &table, int iPos, int iInvalid, const char *szType, bool bAllowInvalid, bool bAllowAnything= false); template struct EnumTraits { static LuaReference StringToEnum; static LuaReference EnumToString; static T Invalid; static const char *szName; }; template LuaReference EnumTraits::StringToEnum; template LuaReference EnumTraits::EnumToString; /** @brief Lua helpers for Enumerators. */ namespace Enum { template static T Check( lua_State *L, int iPos, bool bAllowInvalid = false, bool bAllowAnything= false ) { return (T) CheckEnum(L, EnumTraits::StringToEnum, iPos, EnumTraits::Invalid, EnumTraits::szName, bAllowInvalid, bAllowAnything); } template static void Push( lua_State *L, T iVal ) { /* Enum_Invalid values are nil in Lua. */ if( iVal == EnumTraits::Invalid ) { lua_pushnil( L ); return; } /* Look up the string value. */ EnumTraits::EnumToString.PushSelf( L ); lua_rawgeti( L, -1, iVal + 1 ); lua_remove( L, -2 ); } void SetMetatable( lua_State *L, LuaReference &EnumTable, LuaReference &EnumIndexTable, const char *szName ); template constexpr auto to_integral(E e) { return static_cast::type>(e); } }; const RString &EnumToString( int iVal, int iMax, const char **szNameArray, std::unique_ptr *pNameCache ); // XToString helper #define XToString(X) \ const RString& X##ToString(X x); \ static_assert( NUM_##X == ARRAYLEN(X##Names) ); \ const RString& X##ToString( X x ) \ { \ static std::unique_ptr as_##X##Name[NUM_##X+2]; \ return EnumToString( x, NUM_##X, X##Names, as_##X##Name ); \ } \ namespace StringConversion { template<> RString ToString( const X &value ) { return X##ToString(value); } } #define XToLocalizedString(X) \ const RString &X##ToLocalizedString(X x); \ const RString &X##ToLocalizedString( X x ) \ { \ static std::unique_ptr g_##X##Name[NUM_##X]; \ if( g_##X##Name[0].get() == nullptr ) { \ for( unsigned i = 0; i < NUM_##X; ++i ) \ { \ std::unique_ptr ap( new LocalizedString(#X, X##ToString((X)i)) ); \ g_##X##Name[i] = std::move(ap); \ } \ } \ return g_##X##Name[x]->GetValue(); \ } #define StringToX(X) \ X StringTo##X(const RString&); \ X StringTo##X( const RString& s ) \ { \ for( unsigned i = 0; i < ARRAYLEN(X##Names); ++i ) \ if( !s.CompareNoCase(X##Names[i]) ) \ return (X)i; \ return X##_Invalid; \ } \ namespace StringConversion \ { \ template<> bool FromString( const RString &sValue, X &out ) \ { \ out = StringTo##X(sValue); \ return out != X##_Invalid; \ } \ } // currently unused #define LuaDeclareType(X) #define LuaXType(X) \ template struct EnumTraits; \ static void Lua##X(lua_State* L) \ { \ /* Create the EnumToString table: { "UnlockEntry_ArcadePoints", "UnlockEntry_DancePoints" } */ \ lua_newtable( L ); \ FOREACH_ENUM( X, i ) \ { \ RString s = X##ToString( i ); \ lua_pushstring( L, (#X "_")+s ); \ lua_rawseti( L, -2, i+1 ); /* 1-based */ \ } \ EnumTraits::EnumToString.SetFromStack( L ); \ EnumTraits::EnumToString.PushSelf( L ); \ lua_setglobal( L, #X ); \ /* Create the StringToEnum table: { "UnlockEntry_ArcadePoints" = 0, "UnlockEntry_DancePoints" = 1 } */ \ lua_newtable( L ); \ FOREACH_ENUM( X, i ) \ { \ RString s = X##ToString( i ); \ lua_pushstring( L, (#X "_")+s ); \ lua_pushnumber( L, i ); /* 0-based */ \ lua_rawset( L, -3 ); \ /* Compatibility with old, case-insensitive values */ \ s.MakeLower(); \ lua_pushstring( L, s ); \ lua_pushnumber( L, i ); /* 0-based */ \ lua_rawset( L, -3 ); \ /* Compatibility with old, raw values */ \ lua_pushnumber( L, i ); \ lua_rawseti( L, -2, i ); \ } \ EnumTraits::StringToEnum.SetFromStack( L ); \ EnumTraits::StringToEnum.PushSelf( L ); \ Enum::SetMetatable( L, EnumTraits::EnumToString, EnumTraits::StringToEnum, #X ); \ } \ REGISTER_WITH_LUA_FUNCTION( Lua##X ); \ template<> X EnumTraits::Invalid = X##_Invalid; \ template<> const char *EnumTraits::szName = #X; \ namespace LuaHelpers \ { \ template<> bool FromStack( lua_State *L, X &Object, int iOffset ) \ { \ Object = Enum::Check( L, iOffset, true ); \ return Object != EnumTraits::Invalid; \ } \ } \ namespace LuaHelpers \ { \ template<> void Push( lua_State *L, const X &Object ) \ { \ Enum::Push( L, Object ); \ } \ } #endif /** * @file * @author Chris Danford, Glenn Maynard (c) 2004-2006 * @section LICENSE * All rights reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, and/or sell copies of the Software, and to permit persons to * whom the Software is furnished to do so, provided that the above * copyright notice(s) and this permission notice appear in all copies of * the Software and that both the above copyright notice(s) and this * permission notice appear in supporting documentation. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF * THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS * INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT * OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. */