MRStringConvert.h

Go to the documentation of this file.

#pragma once
 
#include "MRMeshFwd.h"
#include <filesystem>
#include <string>
#include "MRExpected.h"
 
namespace MR
{
 
 
[[nodiscard]] MRMESH_API std::wstring utf8ToWide( const char* utf8 );
 
[[nodiscard]] MRMESH_API std::string systemToUtf8( const std::string & system );
 
[[nodiscard]] MRMESH_API std::string utf8ToSystem( const std::string & utf8 );
 
[[nodiscard]] MRMESH_API std::string wideToUtf8( const wchar_t * wide );
 
#ifdef _WIN32
[[nodiscard]] MRMESH_API std::string Utf16ToUtf8( const std::wstring_view & utf16 );
#endif
 
#if defined __cpp_lib_char8_t
 
[[nodiscard]] inline std::string asString( const std::u8string & s ) { return { s.begin(), s.end() }; }
[[nodiscard]] inline std::u8string asU8String( const std::string & s ) { return { s.begin(), s.end() }; }
 
#if defined( _LIBCPP_VERSION ) && _LIBCPP_VERSION < 12000
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const std::string & s ) { return std::filesystem::path( s ); }
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const char * s ) { return std::filesystem::path( std::string( s ) ); }
#else
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const std::string & s ) { return std::filesystem::path( asU8String( s ) ); }
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const char * s ) { return std::filesystem::path( asU8String( std::string( s ) ) ); }
#endif
 
#else // std::u8string is not defined
 
[[nodiscard]] inline const std::string & asString( const std::string & s ) { return s; }
[[nodiscard]] inline const std::string & asU8String( const std::string & s ) { return s; }
 
[[nodiscard]] inline std::string asString( std::string && s ) { return std::move( s ); }
[[nodiscard]] inline std::string asU8String( std::string && s ) { return std::move( s ); }
 
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const std::string & s ) { return std::filesystem::u8path( s ); }
[[nodiscard]] inline std::filesystem::path pathFromUtf8( const char * s ) { return std::filesystem::u8path( s ); }
 
#endif
 
#if defined( _LIBCPP_VERSION ) && _LIBCPP_VERSION < 12000
[[nodiscard]] inline std::string utf8string( const std::filesystem::path & path )
    { return path.u8string(); }
#else
[[nodiscard]] inline std::string utf8string( const std::filesystem::path & path )
    { return asString( path.u8string() ); }
#endif
 
 
[[nodiscard]] MRMESH_API std::string bytesString( size_t size );
 
[[nodiscard]] MRMESH_API bool hasProhibitedChars( const std::string& line );
 
[[nodiscard]] MRMESH_API std::string replaceProhibitedChars( const std::string& line, char replacement = '_' );
 
template<typename T>
[[nodiscard]] inline Expected<T> addFileNameInError( Expected<T> v, const std::filesystem::path & file )
{
    if ( !v.has_value() )
        v = unexpected( v.error() + ": " + utf8string( file ) );
    return v;
}
 
[[nodiscard]] MRMESH_API std::string commonFilesName( const std::vector<std::filesystem::path> & files );
 
[[deprecated("Use `valueToString()` from `MRViewer/MRUnits.h` instead!")]]
MRMESH_API char * formatNoTrailingZeros( char * fmt, double v, int digitsAfterPoint, int precision = 6 );
 
[[nodiscard]] MRMESH_API double roundToPrecision( double v, int precision );
 
[[nodiscard]] inline float roundToPrecision( float v, int precision ) { return (float)roundToPrecision( double(v), precision ); }
 
// Returns message showed when loading is canceled
[[nodiscard]] inline std::string getCancelMessage( const std::filesystem::path& path )
{
    return "Loading canceled: " + utf8string( path );
}
 
[[nodiscard]] MRMESH_API std::string toLower( std::string str );
 
} //namespace MR