ConstStringBase.hpp

Go to the documentation of this file.

#ifndef FW_CONST_STRING_BASE_HPP
#define FW_CONST_STRING_BASE_HPP

#include <Fw/FPrimeBasicTypes.hpp>
#include <Fw/Types/Serializable.hpp>
#include <Fw/Types/format.hpp>
#include <cstdarg>
#ifdef BUILD_UT
#include <iostream>
#endif

namespace Fw {

class ConstStringBase : public Serializable {
  public:
    using SizeType = FwSizeType;

    virtual const CHAR* toChar() const = 0;
    virtual SizeType getCapacity() const = 0;
    virtual SizeType length() const;
    SizeType maxLength() const;
    SizeType maxLength(SizeType capacity) 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;

    bool operator==(const ConstStringBase& other) const;  
    bool operator==(const CHAR* other) const;             
    bool operator!=(const ConstStringBase& other) const;  
    bool operator!=(const CHAR* other) const;             

    SerializeStatus serializeTo(SerialBufferBase& buffer, Endianness mode = Endianness::BIG) const override;
    virtual SerializeStatus serializeTo(SerialBufferBase& buffer,
                                        SizeType maxLen,
                                        Endianness mode = Endianness::BIG) const;
    // NOTE: all derived classes should override this function; it will always return an error
    // status since ConstStringBase is immutable and deserializeFrom is not a read-only operation
    SerializeStatus deserializeFrom(SerialBufferBase& buffer, Endianness mode = Endianness::BIG) override;

    DEPRECATED(SerializeStatus serialize(SerialBufferBase& buffer) const,
               "Use serializeTo(LinearBufferBase& buffer) instead") {
        return this->serializeTo(buffer);
    }

    DEPRECATED(SerializeStatus serialize(SerialBufferBase& buffer, SizeType maxLen) const,
               "Use serializeTo(LinearBufferBase& buffer, SizeType maxLen) instead") {
        return this->serializeTo(buffer, maxLen);
    }

#ifdef BUILD_UT
    // to support GoogleTest framework in unit tests
    friend std::ostream& operator<<(std::ostream& os, const ConstStringBase& str);
#endif

#if FW_SERIALIZABLE_TO_STRING || BUILD_UT
    void toString(StringBase& text) const override;  
#endif

  protected:
    ConstStringBase();
    virtual ~ConstStringBase();

  private:
    ConstStringBase(const ConstStringBase& src) = delete;
};

}  // namespace Fw

#endif