Function Sys_GetSaveFile

engine/script/src/script_sys.cpp:373–397

gets the save-file path * The save-file path is operating system specific and is typically located under the user's home directory. * This function will raise a Lua error if unable to get the save file path. * * @note Setting the environment variable `DM_SAVE_HOME` overrides the default application support path. * * @name sys.get_save_file * @param application_id

     * ```
     */
    static int Sys_GetSaveFile(lua_State* L)
    {
        const char* application_id = luaL_checkstring(L, 1);

        char app_support_path[1024];
        dmSys::Result r = dmSys::GetApplicationSavePath(application_id, app_support_path, sizeof(app_support_path));
        if (r != dmSys::RESULT_OK)
        {
            return luaL_error(L, "Unable to locate application support path for \"%s\": (%d)", application_id, r);
        }

        const char* filename = luaL_checkstring(L, 2);
        char* dm_home = dmSys::GetEnv("DM_SAVE_HOME");
        // Higher priority
        if (dm_home)
        {
            dmStrlCpy(app_support_path, dm_home, sizeof(app_support_path));
        }

        dmStrlCat(app_support_path, dmPath::PATH_CHARACTER, sizeof(app_support_path));
        dmStrlCat(app_support_path, filename, sizeof(app_support_path));
        lua_pushstring(L, app_support_path);

        return 1;
    }


    /*# gets the application path