// SPDX-FileCopyrightText: 2019-2023 Connor McLaughlin // SPDX-License-Identifier: (GPL-3.0 OR CC-BY-NC-ND-4.0) #pragma once #include "common/types.h" #include #include #include #include #include namespace Host { /// Reads a file from the resources directory of the application. /// This may be outside of the "normal" filesystem on platforms such as Mac. std::optional> ReadResourceFile(const char* filename); /// Reads a resource file file from the resources directory as a string. std::optional ReadResourceFileToString(const char* filename); /// Returns the modified time of a resource. std::optional GetResourceFileTimestamp(const char* filename); /// Displays an asynchronous error on the UI thread, i.e. doesn't block the caller. void ReportErrorAsync(const std::string_view& title, const std::string_view& message); void ReportFormattedErrorAsync(const std::string_view& title, const char* format, ...); /// Displays a synchronous confirmation on the UI thread, i.e. blocks the caller. bool ConfirmMessage(const std::string_view& title, const std::string_view& message); bool ConfirmFormattedMessage(const std::string_view& title, const char* format, ...); /// Opens a URL, using the default application. void OpenURL(const std::string_view& url); /// Copies the provided text to the host's clipboard, if present. bool CopyTextToClipboard(const std::string_view& text); /// Returns a localized version of the specified string within the specified context. /// The pointer is guaranteed to be valid until the next language change. const char* TranslateToCString(const std::string_view& context, const std::string_view& msg); /// Returns a localized version of the specified string within the specified context. /// The view is guaranteed to be valid until the next language change. /// NOTE: When passing this to fmt, positional arguments should be used in the base string, as /// not all locales follow the same word ordering. std::string_view TranslateToStringView(const std::string_view& context, const std::string_view& msg); /// Returns a localized version of the specified string within the specified context. std::string TranslateToString(const std::string_view& context, const std::string_view& msg); /// Clears the translation cache. All previously used strings should be considered invalid. void ClearTranslationCache(); namespace Internal { /// Implementation to retrieve a translated string. s32 GetTranslatedStringImpl(const std::string_view& context, const std::string_view& msg, char* tbuf, size_t tbuf_space); } // namespace Internal } // namespace Host // Helper macros for retrieving translated strings. #define TRANSLATE(context, msg) Host::TranslateToCString(context, msg) #define TRANSLATE_SV(context, msg) Host::TranslateToStringView(context, msg) #define TRANSLATE_STR(context, msg) Host::TranslateToString(context, msg) #define TRANSLATE_FS(context, msg) fmt::runtime(Host::TranslateToStringView(context, msg)) // Does not translate the string at runtime, but allows the UI to in its own way. #define TRANSLATE_NOOP(context, msg) msg