Function Msg_Post

engine/script/src/script_msg.cpp:486–556

posts a message to a receiving URL * * Post a message to a receiving URL. The most common case is to send messages * to a component. If the component part of the receiver is omitted, the message * is broadcast to all components in the game object. * * The following receiver shorthands are available: * * - `"."` the current game object * - `"#"` the curr

     * ```
     */
    int Msg_Post(lua_State* L)
    {
        int top = lua_gettop(L);
        if (lua_isnil(L, 1))
        {
            return luaL_error(L, "The receiver shouldn't be `nil`");
        }

        dmMessage::URL receiver;
        dmMessage::URL sender;
        ResolveURL(L, 1, &receiver, &sender);

        dmhash_t message_id;
        if (lua_isstring(L, 2))
        {
            message_id = dmHashString64(lua_tostring(L, 2));
        }
        else
        {
            message_id = CheckHash(L, 2);
        }

        char DM_ALIGNED(16) data[MAX_MESSAGE_DATA_SIZE];
        uint32_t data_size = 0;


        const dmDDF::Descriptor* desc = dmDDF::GetDescriptorFromHash(message_id);
        if (desc != 0)
        {
            if (desc->m_Size > MAX_MESSAGE_DATA_SIZE)
            {
                return luaL_error(L, "The message is too large to be sent (%d bytes, max is %d).", desc->m_Size, MAX_MESSAGE_DATA_SIZE);
            }
            if (top > 2)
            {
                luaL_checktype(L, 3, LUA_TTABLE);
                lua_pushvalue(L, 3);
            }
            else
            {
                lua_newtable(L);
            }
            data_size = dmScript::CheckDDF(L, desc, data, MAX_MESSAGE_DATA_SIZE, -1);
            lua_pop(L, 1);
        }
        else if (top > 2)
        {
            if (!lua_isnil(L, 3))
            {
                data_size = dmScript::CheckTable(L, data, MAX_MESSAGE_DATA_SIZE, 3);
            }
        }

        assert(top == lua_gettop(L));

        dmMessage::Result result = dmMessage::Post(&sender, &receiver, message_id, 0, (uintptr_t) desc, data, data_size, 0);
        if (result == dmMessage::RESULT_SOCKET_NOT_FOUND)
        {