// Copyright 2008 Dolphin Emulator Project // Licensed under GPLv2+ // Refer to the license.txt file included. #pragma once #include #include #include #include #include #include #include #include #include #include "Common/CommonTypes.h" #ifdef _MSC_VER #include #define HAS_STD_FILESYSTEM #endif std::string StringFromFormatV(const char* format, va_list args); std::string StringFromFormat(const char* format, ...) #if !defined _WIN32 // On compilers that support function attributes, this gives StringFromFormat // the same errors and warnings that printf would give. __attribute__((__format__(printf, 1, 2))) #endif ; // Cheap! bool CharArrayFromFormatV(char* out, int outsize, const char* format, va_list args); template inline void CharArrayFromFormat(char (&out)[Count], const char* format, ...) { va_list args; va_start(args, format); CharArrayFromFormatV(out, Count, format, args); va_end(args); } // Good std::string ArrayToString(const u8* data, u32 size, int line_len = 20, bool spaces = true); std::string_view StripSpaces(std::string_view s); std::string_view StripQuotes(std::string_view s); std::string ReplaceAll(std::string result, std::string_view src, std::string_view dest); bool TryParse(const std::string& str, bool* output); template || std::is_enum_v>* = nullptr> bool TryParse(const std::string& str, T* output) { char* end_ptr = nullptr; // Set errno to a clean slate. errno = 0; // Read a u64 for unsigned types and s64 otherwise. using ReadType = std::conditional_t, u64, s64>; ReadType value; if constexpr (std::is_unsigned_v) value = std::strtoull(str.c_str(), &end_ptr, 0); else value = std::strtoll(str.c_str(), &end_ptr, 0); // Fail if the end of the string wasn't reached. if (end_ptr == nullptr || *end_ptr != '\0') return false; // Fail if the value was out of 64-bit range. if (errno == ERANGE) return false; using LimitsType = typename std::conditional_t, std::underlying_type, std::common_type>::type; // Fail if outside numeric limits. if (value < std::numeric_limits::min() || value > std::numeric_limits::max()) { return false; } *output = static_cast(value); return true; } template >* = nullptr> bool TryParse(std::string str, T* const output) { // Replace commas with dots. std::istringstream iss(ReplaceAll(std::move(str), ",", ".")); // Use "classic" locale to force a "dot" decimal separator. iss.imbue(std::locale::classic()); T tmp; // Succeed if a value was read and the entire string was used. if (iss >> tmp && iss.eof()) { *output = tmp; return true; } return false; } template bool TryParseVector(const std::string& str, std::vector* output, const char delimiter = ',') { output->clear(); std::istringstream buffer(str); std::string variable; while (std::getline(buffer, variable, delimiter)) { N tmp = 0; if (!TryParse(variable, &tmp)) return false; output->push_back(tmp); } return true; } std::string ValueToString(u16 value); std::string ValueToString(u32 value); std::string ValueToString(u64 value); std::string ValueToString(float value); std::string ValueToString(double value); std::string ValueToString(int value); std::string ValueToString(s64 value); std::string ValueToString(bool value); template ::value>* = nullptr> std::string ValueToString(T value) { return ValueToString(static_cast>(value)); } // Generates an hexdump-like representation of a binary data blob. std::string HexDump(const u8* data, size_t size); // TODO: kill this bool AsciiToHex(const std::string& _szValue, u32& result); std::string TabsToSpaces(int tab_size, std::string str); std::vector SplitString(const std::string& str, char delim); std::string JoinStrings(const std::vector& strings, const std::string& delimiter); // "C:/Windows/winhelp.exe" to "C:/Windows/", "winhelp", ".exe" bool SplitPath(std::string_view full_path, std::string* path, std::string* filename, std::string* extension); void BuildCompleteFilename(std::string& complete_filename, std::string_view path, std::string_view filename); bool StringBeginsWith(std::string_view str, std::string_view begin); bool StringEndsWith(std::string_view str, std::string_view end); void StringPopBackIf(std::string* s, char c); std::string CP1252ToUTF8(std::string_view str); std::string SHIFTJISToUTF8(std::string_view str); std::string UTF8ToSHIFTJIS(std::string_view str); std::string UTF16ToUTF8(std::wstring_view str); std::string UTF16BEToUTF8(const char16_t* str, size_t max_size); // Stops at \0 #ifdef _WIN32 std::wstring UTF8ToUTF16(std::string_view str); #ifdef _UNICODE inline std::string TStrToUTF8(std::wstring_view str) { return UTF16ToUTF8(str); } inline std::wstring UTF8ToTStr(std::string_view str) { return UTF8ToUTF16(str); } #else inline std::string TStrToUTF8(std::string_view str) { return str; } inline std::string UTF8ToTStr(std::string_view str) { return str; } #endif #endif #ifdef HAS_STD_FILESYSTEM std::filesystem::path StringToPath(std::string_view path); std::string PathToString(const std::filesystem::path& path); #endif // Thousand separator. Turns 12345678 into 12,345,678 template std::string ThousandSeparate(I value, int spaces = 0) { #ifdef _WIN32 std::wostringstream stream; #else std::ostringstream stream; #endif stream << std::setw(spaces) << value; #ifdef _WIN32 return UTF16ToUTF8(stream.str()); #else return stream.str(); #endif } /// Returns whether a character is printable, i.e. whether 0x20 <= c <= 0x7e is true. /// Use this instead of calling std::isprint directly to ensure /// the C locale is being used and to avoid possibly undefined behaviour. inline bool IsPrintableCharacter(char c) { return std::isprint(c, std::locale::classic()); }