mirror of
https://github.com/OpenRCT2/OpenRCT2
synced 2026-01-24 15:24:30 +01:00
13c326eb50
OpenRCT2 used to incorrectly write UTF-8 to SV6 names and descriptions. This fixes reading such scenarios. It should also fix the game crashing when attempting to load such a scenario. What this doesn't do is add support for the encoding that vanilla used for CJK, or add support for creating scenarios with Korean descriptions. That will only be feasible when switching to our own format.
120 lines
4.7 KiB
C++
120 lines
4.7 KiB
C++
/*****************************************************************************
|
|
* Copyright (c) 2014-2018 OpenRCT2 developers
|
|
*
|
|
* For a complete list of all authors, please refer to contributors.md
|
|
* Interested in contributing? Visit https://github.com/OpenRCT2/OpenRCT2
|
|
*
|
|
* OpenRCT2 is licensed under the GNU General Public License version 3.
|
|
*****************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include "../common.h"
|
|
|
|
#include <cstdarg>
|
|
#include <cstddef>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace CODE_PAGE
|
|
{
|
|
// windows.h defines CP_UTF8
|
|
#undef CP_UTF8
|
|
|
|
constexpr int32_t CP_932 = 932; // ANSI/OEM Japanese; Japanese (Shift-JIS)
|
|
constexpr int32_t CP_936 = 936; // ANSI/OEM Simplified Chinese (PRC, Singapore); Chinese Simplified (GB2312)
|
|
constexpr int32_t CP_949 = 949; // ANSI/OEM Korean (Unified Hangul Code)
|
|
constexpr int32_t CP_950 = 950; // ANSI/OEM Traditional Chinese (Taiwan; Hong Kong SAR, PRC); Chinese Traditional (Big5)
|
|
constexpr int32_t CP_1252 = 1252; // ANSI Latin 1; Western European (Windows)
|
|
constexpr int32_t CP_UTF8 = 65001; // Unicode (UTF-8)
|
|
} // namespace CODE_PAGE
|
|
|
|
namespace String
|
|
{
|
|
constexpr const utf8* Empty = "";
|
|
|
|
std::string ToStd(const utf8* str);
|
|
std::string StdFormat_VA(const utf8* format, va_list args);
|
|
std::string StdFormat(const utf8* format, ...);
|
|
std::string ToUtf8(const std::wstring_view& src);
|
|
std::wstring ToUtf16(const std::string_view& src);
|
|
|
|
bool IsNullOrEmpty(const utf8* str);
|
|
int32_t Compare(const std::string& a, const std::string& b, bool ignoreCase = false);
|
|
int32_t Compare(const utf8* a, const utf8* b, bool ignoreCase = false);
|
|
bool Equals(const std::string& a, const std::string& b, bool ignoreCase = false);
|
|
bool Equals(const utf8* a, const utf8* b, bool ignoreCase = false);
|
|
bool StartsWith(const utf8* str, const utf8* match, bool ignoreCase = false);
|
|
bool StartsWith(const std::string& str, const std::string& match, bool ignoreCase = false);
|
|
bool EndsWith(const std::string_view& str, const std::string_view& match, bool ignoreCase = false);
|
|
size_t IndexOf(const utf8* str, utf8 match, size_t startIndex = 0);
|
|
ptrdiff_t LastIndexOf(const utf8* str, utf8 match);
|
|
|
|
/**
|
|
* Gets the length of the given string in codepoints.
|
|
*/
|
|
size_t LengthOf(const utf8* str);
|
|
|
|
/**
|
|
* Gets the size of the given string in bytes excluding the null terminator.
|
|
*/
|
|
size_t SizeOf(const utf8* str);
|
|
|
|
utf8* Set(utf8* buffer, size_t bufferSize, const utf8* src);
|
|
utf8* Set(utf8* buffer, size_t bufferSize, const utf8* src, size_t srcSize);
|
|
utf8* Append(utf8* buffer, size_t bufferSize, const utf8* src);
|
|
utf8* Format(utf8* buffer, size_t bufferSize, const utf8* format, ...);
|
|
utf8* Format(const utf8* format, ...);
|
|
utf8* Format_VA(const utf8* format, va_list args);
|
|
utf8* AppendFormat(utf8* buffer, size_t bufferSize, const utf8* format, ...);
|
|
utf8* Duplicate(const std::string& src);
|
|
utf8* Duplicate(const utf8* src);
|
|
|
|
/**
|
|
* Helper method to free the string a string pointer points to and set it to a replacement string.
|
|
*/
|
|
utf8* DiscardUse(utf8** ptr, utf8* replacement);
|
|
|
|
/**
|
|
* Helper method to free the string a string pointer points to and set it to a copy of a replacement string.
|
|
*/
|
|
utf8* DiscardDuplicate(utf8** ptr, const utf8* replacement);
|
|
|
|
/**
|
|
* Splits the given string by a delimiter and returns the values as a new string array.
|
|
* @returns the number of values.
|
|
*/
|
|
std::vector<std::string> Split(const std::string& s, const std::string& delimiter);
|
|
|
|
utf8* SkipBOM(utf8* buffer);
|
|
const utf8* SkipBOM(const utf8* buffer);
|
|
|
|
size_t GetCodepointLength(codepoint_t codepoint);
|
|
codepoint_t GetNextCodepoint(utf8* ptr, utf8** nextPtr = nullptr);
|
|
codepoint_t GetNextCodepoint(const utf8* ptr, const utf8** nextPtr = nullptr);
|
|
utf8* WriteCodepoint(utf8* dst, codepoint_t codepoint);
|
|
|
|
bool IsWhiteSpace(codepoint_t codepoint);
|
|
utf8* Trim(utf8* str);
|
|
const utf8* TrimStart(const utf8* str);
|
|
utf8* TrimStart(utf8* buffer, size_t bufferSize, const utf8* src);
|
|
std::string TrimStart(const std::string& s);
|
|
std::string Trim(const std::string& s);
|
|
|
|
/**
|
|
* Converts a multi-byte string from one code page to another.
|
|
*/
|
|
std::string Convert(const std::string_view& src, int32_t srcCodePage, int32_t dstCodePage);
|
|
|
|
/**
|
|
* Returns an uppercased version of a UTF-8 string.
|
|
*/
|
|
std::string ToUpper(const std::string_view& src);
|
|
|
|
/**
|
|
* Returns true if the string contains an RCT2 colour code.
|
|
*/
|
|
bool ContainsColourCode(const std::string& string);
|
|
|
|
} // namespace String
|