ParseFormat.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstUtil/StringView.hpp"
#include "AstUtil/Logger.hpp"
#include "AstUtil/Color.hpp"
#include <string>
 
 
AST_NAMESPACE_BEGIN
 
AST_UTIL_CAPI errc_t aParseBool(StringView str, bool& value);
 
 
AST_UTIL_CAPI errc_t aParseInt(StringView str, int& value);
 
 
AST_UTIL_CAPI errc_t _aParseInt_LibC_1(StringView str, int& value);      // 基于 strtol 函数(stol函数)，堆内存
AST_UTIL_CAPI errc_t _aParseInt_LibC_2(StringView str, int& value);      // 基于 atoi 函数
AST_UTIL_CAPI errc_t _aParseInt_LibC_3(StringView str, int& value);      // 基于 strtol 函数(stol函数)，栈内存
 
 
#ifdef A_CXX17
AST_UTIL_CAPI errc_t _aParseInt_FromChars(StringView str, int& value);    // 基于 std::from_chars 函数
#endif
 
 
AST_UTIL_CAPI errc_t _aParseInt_Simple(StringView str, int& value);
 
 
AST_UTIL_CAPI errc_t _aParseInt_StringStream(StringView str, int& value);
 
 
AST_UTIL_CAPI errc_t _aParseInt_Scanf(StringView str, int& value);      // 基于 scanf 函数
 
 
AST_UTIL_CAPI errc_t aParseDouble(StringView str, double& value);
 
 
AST_UTIL_CAPI errc_t aParseFortranDouble(StringView str, double& value);
AST_UTIL_CAPI errc_t _aParseFortranDouble_1(StringView str, double& value);  // 堆内存
AST_UTIL_CAPI errc_t _aParseFortranDouble_2(StringView str, double& value);  // 栈内存
 
 
 
AST_UTIL_CAPI errc_t _aParseDouble_LibC_1(StringView str, double& value);  // 基于 strtod 函数(stod函数)，堆内存
AST_UTIL_CAPI errc_t _aParseDouble_LibC_2(StringView str, double& value);  // 基于 atof 函数
AST_UTIL_CAPI errc_t _aParseDouble_LibC_3(StringView str, double& value);  // 基于 strtod 函数(stod函数)，栈内存
 
 
#ifdef A_CXX17
AST_UTIL_CAPI errc_t _aParseDouble_FromChars(StringView str, double& value);    // 基于 std::from_chars 函数
#endif
 
#ifdef AST_WITH_ABSEIL
AST_UTIL_CAPI errc_t _aParseDouble_FromChars_Abseil(StringView str, double& value);
#endif
 
AST_UTIL_CAPI errc_t _aParseDouble_StringStream(StringView str, double& value);
 
 
 
AST_UTIL_CAPI errc_t _aParseDouble_Scanf(StringView str, double& value);      // 基于 scanf 函数
 
 
 
AST_UTIL_CAPI errc_t aParseColor(StringView str, Color& value);
 
 
 
AST_UTIL_CAPI void aFormatBool(bool value, std::string& str);
 
 
 
AST_UTIL_CAPI errc_t aFormatInt(int value, std::string& str);
 
 
enum {kDefaultFormatDoubleEps = -1};
 
AST_UTIL_CAPI errc_t aFormatDouble(double value, std::string& str, int precision = kDefaultFormatDoubleEps);
 
 
AST_UTIL_CAPI errc_t aFormatColor(Color value, std::string& str);
 
 
AST_UTIL_API std::string aFormatBytes(uint64_t bytes);
 
 
// alias
// 下面是内联函数的实现
 
 
A_ALWAYS_INLINE
std::string aFormatBool(bool value)
{
    std::string str;
    aFormatBool(value, str);
    return str;
}
 
 
A_ALWAYS_INLINE
std::string aFormatInt(int value)
{
    std::string str;
    errc_t err = aFormatInt(value, str);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("格式化整数值失败，错误 = %d"), err);
    }
    return str;
}
 
 
A_ALWAYS_INLINE
std::string aFormatDouble(double value, int precision = kDefaultFormatDoubleEps)
{
    std::string str;
    errc_t err = aFormatDouble(value, str, precision);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("格式化双精度浮点数值失败，错误 = %d"), err);
    }
    return str;
}
 
A_ALWAYS_INLINE
std::string aFormatColor(Color value)
{
    std::string str;
    errc_t err = aFormatColor(value, str);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("格式化颜色值失败，错误 = %d"), err);
    }
    return str;
}
 
 
A_ALWAYS_INLINE
bool aParseBool(StringView str)
{
    bool value;
    errc_t err = aParseBool(str, value);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("从 '%.*s' 解析布尔值失败，错误 = %d"), str.size(), str.data(), err);
    }
    return value;
}
 
A_ALWAYS_INLINE
int aParseInt(StringView str)
{
    int value;
    errc_t err = aParseInt(str, value);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("从 '%.*s' 解析整数值失败，错误 = %d"), str.size(), str.data(), err);
    }
    return value;
}
 
 
A_ALWAYS_INLINE
double aParseDouble(StringView str)
{
    double value;
    errc_t err = aParseDouble(str, value);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("从 '%.*s' 解析双精度浮点数值失败，错误 = %d"), str.size(), str.data(), err);
    }
    return value;
}
 
A_ALWAYS_INLINE
double aParseFortranDouble(StringView str)
{
    double value;
    errc_t err = aParseFortranDouble(str, value);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("从 '%.*s' 解析 Fortran 双精度浮点数值失败，错误 = %d"), str.size(), str.data(), err);
    }
    return value;
}
 
 
A_ALWAYS_INLINE
Color aParseColor(StringView str)
{
    Color value;
    errc_t err = aParseColor(str, value);
    if (A_UNLIKELY(err != eNoError))
    {
        aWarning(_("从 '%.*s' 解析颜色值失败，错误 = %d"), str.size(), str.data(), err);
    }
    return value;
}
 
 
A_ALWAYS_INLINE
errc_t aFormatScalar(double value, std::string& str)
{
    return aFormatDouble(value, str);
}
 
 
A_ALWAYS_INLINE
errc_t aFormatScalar(int value, std::string& str)
{
    return aFormatInt(value, str);
}
 
 
A_ALWAYS_INLINE
void aFormatScalar(bool value, std::string& str)
{
    return aFormatBool(value, str);
}
 
 
A_ALWAYS_INLINE
std::string aFormatScalar(double value)
{
    return aFormatDouble(value);
}
 
A_ALWAYS_INLINE
std::string aFormatScalar(int value)
{
    return aFormatInt(value);
}
 
 
A_ALWAYS_INLINE
std::string aFormatScalar(bool value)
{
    return aFormatBool(value);
}
 
AST_NAMESPACE_END