ConversionUtils.h

#pragma once
 
#include <Foundation/Basics.h>
#include <Foundation/Math/Color.h>
#include <Foundation/Math/Mat3.h>
#include <Foundation/Math/Mat4.h>
#include <Foundation/Math/Quat.h>
#include <Foundation/Math/Transform.h>
#include <Foundation/Strings/String.h>
#include <Foundation/Time/Time.h>
#include <Foundation/Types/Uuid.h>
 
namespace plConversionUtils
{
  PL_FOUNDATION_DLL plResult StringToInt(plStringView sText, plInt32& out_iRes, const char** out_pLastParsePosition = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plResult StringToUInt(plStringView sText, plUInt32& out_uiRes, const char** out_pLastParsePosition = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plResult StringToInt64(plStringView sText, plInt64& out_iRes, const char** out_pLastParsePosition = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plResult StringToFloat(plStringView sText, double& out_fRes, const char** out_pLastParsePosition = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plResult StringToBool(plStringView sText, bool& out_bRes, const char** out_pLastParsePosition = nullptr); // [tested]
 
 
  PL_FOUNDATION_DLL plUInt32 ExtractFloatsFromString(plStringView sText, plUInt32 uiNumFloats, float* out_pFloats, const char** out_pLastParsePosition = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plInt8 HexCharacterToIntValue(plUInt32 uiCharacter); // [tested]
 
  PL_FOUNDATION_DLL plResult ConvertHexStringToUInt32(plStringView sHex, plUInt32& out_uiResult); // [tested]
 
  PL_FOUNDATION_DLL plResult ConvertHexStringToUInt64(plStringView sHex, plUInt64& out_uiResult); // [tested]
 
  PL_FOUNDATION_DLL plResult ConvertHexStringToUInt(plStringView sHex, plUInt64& out_uiResult, plUInt32 uiMaxHexCharacters, plUInt32* pTotalCharactersParsed); // [tested]
 
  PL_FOUNDATION_DLL void ConvertHexToBinary(plStringView sText, plUInt8* pBinary, plUInt32 uiBinaryBuffer); // [tested]
 
  template <typename APPEND_CONTAINER_LAMBDA>
  inline void ConvertBinaryToHex(const void* pBinaryData, plUInt32 uiBytes, APPEND_CONTAINER_LAMBDA append); // [tested]
 
  PL_FOUNDATION_DLL plUuid ConvertStringToUuid(plStringView sText); // [tested]
 
  PL_FOUNDATION_DLL bool IsStringUuid(plStringView sText); // [tested]
 
  PL_ALWAYS_INLINE const plStringBuilder& ToString(bool value, plStringBuilder& out_sResult) // [tested]
  {
    out_sResult = value ? "true" : "false";
    return out_sResult;
  }
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plInt8 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plUInt8 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plInt16 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plUInt16 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plInt32 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plUInt32 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plInt64 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(plUInt64 value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(float value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(double value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plColor& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plColorGammaUB& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec2& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec3& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec4& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec2I32& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec3I32& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plVec4I32& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plQuat& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plMat3& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plMat4& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plTransform& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plUuid& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plAngle& value, plStringBuilder& out_sResult); // [tested]
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plTime& value, plStringBuilder& out_sResult);
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plStringView& value, plStringBuilder& out_sResult);
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plHashedString& value, plStringBuilder& out_sResult);
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plTempHashedString& value, plStringBuilder& out_sResult);
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plDynamicArray<plVariant>& value, plStringBuilder& out_sResult);
 
  PL_FOUNDATION_DLL const plStringBuilder& ToString(const plHashTable<plString, plVariant>& value, plStringBuilder& out_sResult);
 
  template <typename T>
  PL_ALWAYS_INLINE const plStringBuilder& ToString(const T& value, plStringBuilder& out_sResult)
  {
    out_sResult = "N/A";
    return out_sResult;
  }
 
  PL_FOUNDATION_DLL plColor GetColorByName(plStringView sText, bool* out_pValidColorName = nullptr); // [tested]
 
  PL_FOUNDATION_DLL plString GetColorName(const plColor& col); // [tested]
}; // namespace plConversionUtils
 
template <typename APPEND_CONTAINER_LAMBDA>
inline void plConversionUtils::ConvertBinaryToHex(const void* pBinaryData, plUInt32 uiBytes, APPEND_CONTAINER_LAMBDA append) // [tested]
{
  char tmp[4];
 
  plUInt8* pBytes = (plUInt8*)pBinaryData;
 
  for (plUInt32 i = 0; i < uiBytes; ++i)
  {
    plStringUtils::snprintf(tmp, 4, "%02X", (plUInt32)*pBytes);
    ++pBytes;
 
    append(tmp);
  }
}