Class LocalizedText

src/Engine/LocalizedText.h:45–72

* A string that is already translated. * Using this class allows argument substitution in the translated strings. */

 * Using this class allows argument substitution in the translated strings.
 */
class LocalizedText
{
public:
	/// Create from existing unicode string.
	LocalizedText(const std::wstring &);
	/// Create the empty string.
	LocalizedText() : _text(L""), _nextArg(1) { /* Empty by design. */ }
	/// Return constant wide string.
	operator std::wstring const& () const OX_REQUIRED_RESULT;
	/// Return the UTF-8 representation of this string.
	std::string asUTF8() const OX_REQUIRED_RESULT;
	/// Get a pointer to underlying wchat_t data.
	const wchar_t *c_str() const OX_REQUIRED_RESULT { return _text.c_str(); }

	// Argument substitution.
	/// Replace next argument.
	LocalizedText arg(std::wstring const &) const OX_REQUIRED_RESULT;
	/// Replace next argument.
	LocalizedText &arg(std::wstring const &) OX_REQUIRED_RESULT;
	/// Replace next argument.
	template <typename T> LocalizedText arg(T) const OX_REQUIRED_RESULT;
	/// Replace next argument.
	template <typename T> LocalizedText &arg(T) OX_REQUIRED_RESULT;
private:
	std::wstring _text; ///< The actual localized text.
	unsigned _nextArg; ///< The next argument ID.
	LocalizedText(const std::wstring &, unsigned);
};

/**
 * Create a LocalizedText from a localized std::wstring.