FormatString.h

#pragma once
 
#ifndef PL_INCLUDING_BASICS_H
#  error "Please don't include FormatString.h directly, but instead include Foundation/Basics.h"
#endif
 
class plStringBuilder;
 
#include <Foundation/Strings/StringView.h>
 
#include <Foundation/Strings/Implementation/FormatStringArgs.h>
 
class PL_FOUNDATION_DLL plFormatString
{
  PL_DISALLOW_COPY_AND_ASSIGN(plFormatString); // pass by reference, never pass by value
 
public:
  PL_ALWAYS_INLINE plFormatString() = default;
  PL_ALWAYS_INLINE plFormatString(const char* szString) { m_sString = szString; }
  PL_ALWAYS_INLINE plFormatString(plStringView sString) { m_sString = sString; }
  plFormatString(const plStringBuilder& s);
  virtual ~plFormatString() = default;
 
  [[nodiscard]] virtual plStringView GetText(plStringBuilder&) const { return m_sString; }
 
  virtual const char* GetTextCStr(plStringBuilder& out_sString) const;
 
  bool IsEmpty() const { return m_sString.IsEmpty(); }
 
  plStringView BuildFormattedText(plStringBuilder& ref_sStorage, plStringView* pArgs, plUInt32 uiNumArgs) const;
 
protected:
  plStringView m_sString;
};
 
#include <Foundation/Strings/Implementation/FormatStringImpl.h>
 
template <typename... ARGS>
PL_ALWAYS_INLINE plFormatStringImpl<ARGS...> plFmt(const char* szFormat, ARGS&&... args)
{
  return plFormatStringImpl<ARGS...>(szFormat, std::forward<ARGS>(args)...);
}