RscStringBase.hpp

 
//
//  Copyright Phoenix Contact GmbH & Co. KG
//
#pragma once
#include "Arp/Base/Core/Arp.hpp"
#include "Arp/Base/Rsc/Commons/Rsc.hpp"
 
namespace Arp::Base::Rsc::Commons
{
 
// Type imports
using Arp::Base::Rsc::Commons::Services::RscReader;
using Arp::Base::Rsc::Commons::Services::RscWriter;
 
// forwards
class RscVariantBase;
 
class ARP_EXPORT RscStringBase
{
    friend class RscVariantBase;
 
protected: // construction
    explicit RscStringBase(RscType stringType);
 
    // canonical construction/destruction/assignment
    RscStringBase(const RscStringBase& arg);
    RscStringBase(RscStringBase&& arg)noexcept;
    RscStringBase& operator=(const RscStringBase& arg) = delete;
    RscStringBase& operator=(RscStringBase&& arg)noexcept = delete;
    ~RscStringBase(void);
 
public: // operators
    operator String(void)const; // implicit conversion is intended.
 
public: // friend operators
    friend bool operator==(const RscStringBase& left, const RscStringBase& right)noexcept
    {
        return left.Equals(right);
    }
    friend bool operator!=(const RscStringBase& left, const RscStringBase& right)noexcept
    {
        return !left.Equals(right);
    }
 
public: // properties
    size_t  GetLength(void)const;
 
public: // operations
    const char* CStr(void)const;
    String      ToString(void)const;
    void        Clear(void);
    void        Assign(const char* pChars);
    void        Assign(const String& str);
 
public: // RSC operations
    void Read(RscReader& reader);
    void Write(RscWriter& writer)const;
 
protected: // methods
    void    SetBufferInfo(char* pStringBuffer, size_t bufferSize, size_t strLength = 0);
    void    SetBufferInfo(char* pStringBuffer, size_t bufferSize, const char* pChars);
    void    SetBufferInfo(char* pStringBuffer, size_t bufferSize, const String& str);
    void    Assign(const char* pChars, size_t count);
    void    SetStringType(RscType value);
    RscType GetStringType(void)const;
    bool    Equals(const RscStringBase& other)const;
 
private: // methods
    char*   GetBuffer(void)const; // just used by RscVariantBase
    size_t  GetBufferSize(void)const;
    size_t  GetMaxStringLength(void)const;
 
private: // fields
    size_t  length = 0;
    size_t  bufferSize = 0;
    char*   pBuffer = nullptr;
    RscType stringType = RscType::None;
};
 
} // end of namespace Arp::Base::Rsc::Commons