StringBase.hpp

Go to the documentation of this file.

 
#ifndef FW_STRING_BASE_HPP
#define FW_STRING_BASE_HPP
 
#include <FpConfig.hpp>
#include <Fw/Types/Serializable.hpp>
#include <cstdarg>
#ifdef BUILD_UT
#include <iostream>
#endif
 
namespace Fw {
class StringBase : public Serializable {
  public:
    using SizeType = NATIVE_UINT_TYPE;
    virtual const CHAR* toChar() const = 0;    //<! Convert to a C-style char*
    virtual SizeType getCapacity() const = 0;  
    SizeType length() const;                   
 
    SizeType maxLength() const;
    static constexpr SizeType STATIC_SERIALIZED_SIZE(SizeType maxLength  
    ) {
        return static_cast<SizeType>(sizeof(FwSizeStoreType)) + maxLength;
    }
 
    static constexpr SizeType BUFFER_SIZE(SizeType maxLength  
    ) {
        // Reserve one byte for each character plus one for the null terminator
        return maxLength + 1;
    }
 
    SizeType serializedSize() const;
 
    SizeType serializedTruncatedSize(FwSizeType maxLength  
    ) const;
 
    const CHAR* operator+=(const CHAR* src);              
    const StringBase& operator+=(const StringBase& src);  
    bool operator==(const StringBase& other) const;       
    bool operator==(const CHAR* other) const;             
    bool operator!=(const StringBase& other) const;       
    bool operator!=(const CHAR* other) const;             
    StringBase& operator=(const CHAR* src);               
    StringBase& operator=(const StringBase& src);         
 
    void format(const CHAR* formatString, ...);  
    void vformat(const CHAR* formatString, va_list args);  
 
    virtual SerializeStatus serialize(SerializeBufferBase& buffer) const;                   
    virtual SerializeStatus serialize(SerializeBufferBase& buffer, SizeType maxLen) const;  
    virtual SerializeStatus deserialize(SerializeBufferBase& buffer);  
 
#ifdef BUILD_UT
    // to support GoogleTest framework in unit tests
    friend std::ostream& operator<<(std::ostream& os, const StringBase& str);
#endif
#if FW_SERIALIZABLE_TO_STRING || BUILD_UT
    void toString(StringBase& text) const;  
#endif
 
  protected:
    StringBase();
    virtual ~StringBase();
 
    void appendBuff(const CHAR* buff, SizeType size);
 
  private:
    StringBase(const StringBase& src) = delete;  
};
 
}  // namespace Fw
 
#endif