/* ** stringtable.h ** **--------------------------------------------------------------------------- ** Copyright 1998-2006 Randy Heit ** All rights reserved. ** ** Redistribution and use in source and binary forms, with or without ** modification, are permitted provided that the following conditions ** are met: ** ** 1. Redistributions of source code must retain the above copyright ** notice, this list of conditions and the following disclaimer. ** 2. Redistributions in binary form must reproduce the above copyright ** notice, this list of conditions and the following disclaimer in the ** documentation and/or other materials provided with the distribution. ** 3. The name of the author may not be used to endorse or promote products ** derived from this software without specific prior written permission. ** ** THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR ** IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES ** OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ** IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, ** INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT ** NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF ** THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. **--------------------------------------------------------------------------- ** ** ** FStringTable ** ** This class manages a list of localizable strings stored in a wad file. */ #ifndef __STRINGTABLE_H__ #define __STRINGTABLE_H__ #ifdef _MSC_VER #pragma once #endif #include #include "basics.h" #include "zstring.h" #include "tarray.h" #include "name.h" struct StringtableCallbacks { // These two functions would create a dependency on the game code so they are installed as callbacks. bool (*ValidFilter)(const char* str); int (*GetPlayerGender)(); }; struct TableElement { int filenum; FString strings[4]; }; // This public interface is for Dehacked class StringMap : public TMap { public: const char *MatchString(const char *string) const; }; struct StringMacro { FString Replacements[4]; }; class FStringTable { public: enum : uint32_t { default_table = MAKE_ID('*', '*', 0, 0), global_table = MAKE_ID('*', 0, 0, 0), override_table = MAKE_ID('*', '*', '*', 0) }; using LangMap = TMap; using StringMacroMap = TMap; void LoadStrings(const char *language); void UpdateLanguage(const char* language); StringMap GetDefaultStrings() { return allStrings[default_table]; } // Dehacked needs these for comparison void SetOverrideStrings(StringMap && map) { allStrings.Insert(override_table, map); UpdateLanguage(nullptr); } const char *GetLanguageString(const char *name, uint32_t langtable, int gender = -1) const; bool MatchDefaultString(const char *name, const char *content) const; const char *GetString(const char *name, uint32_t *langtable, int gender = -1) const; const char *operator() (const char *name) const; // Never returns NULL const char *operator[] (const char *name) const { return GetString(name, nullptr); } bool exists(const char *name); void SetCallbacks(StringtableCallbacks* cb) { callbacks = cb; } void InsertString(int lumpnum, int langid, FName label, const FString& string); private: FString activeLanguage; StringMacroMap allMacros; LangMap allStrings; TArray> currentLanguageSet; StringtableCallbacks* callbacks = nullptr; void LoadLanguage (int lumpnum, const TArray &buffer); TArray> parseCSV(const TArray &buffer); bool ParseLanguageCSV(int lumpnum, const TArray &buffer); bool LoadLanguageFromSpreadsheet(int lumpnum, const TArray &buffer); bool readMacros(int lumpnum); void DeleteString(int langid, FName label); void DeleteForLabel(int lumpnum, FName label); static size_t ProcessEscapes (char *str); public: static FString MakeMacro(const char *str) { if (*str == '$') return str; return FString("$") + str; } static FString MakeMacro(const char *str, size_t len) { if (*str == '$') return FString(str, len); return "$" + FString(str, len); } const char* localize(const char* str) { return *str == '$' ? operator()(str + 1) : str; } }; #endif //__STRINGTABLE_H__