ConstExternalString.hpp

Go to the documentation of this file.

// ======================================================================
// @file   ConstExternalString.hpp
// @brief  A string backed by an immutable string literal
// ======================================================================

#ifndef FW_CONST_EXTERNAL_STRING_HPP
#define FW_CONST_EXTERNAL_STRING_HPP

#include <Fw/FPrimeBasicTypes.hpp>
#include <Fw/Types/Assert.hpp>
#include <Fw/Types/StringBase.hpp>

namespace Fw {

class ConstExternalString final : public ConstStringBase {
  public:
    // ----------------------------------------------------------------------
    // Construction and destruction
    // ----------------------------------------------------------------------

    ConstExternalString() : ConstStringBase(), m_bufferPtr(nullptr), m_bufferSize(0) {}

    ConstExternalString(const char* bufferPtr,                
                        ConstStringBase::SizeType bufferSize  
                        )
        : ConstStringBase(), m_bufferPtr(bufferPtr), m_bufferSize(bufferSize) {
        FW_ASSERT(bufferPtr != nullptr);
        FW_ASSERT(bufferSize > 0, static_cast<FwAssertArgType>(bufferSize));
        // Assert that the string length plus the null terminator fills the buffer
        FW_ASSERT(ConstStringBase::length() + 1 == bufferSize,
                  static_cast<FwAssertArgType>(ConstStringBase::length() + 1),
                  static_cast<FwAssertArgType>(bufferSize));
    }

    ~ConstExternalString() {}

  public:
    // ----------------------------------------------------------------------
    // ConstStringBase interface
    // ----------------------------------------------------------------------

    ConstStringBase::SizeType length() const override {
        // The length of the string is 1 less than its capacity (string + null terminator)
        return this->m_bufferSize == 0 ? 0 : this->m_bufferSize - 1;
    }

    const char* toChar() const override { return this->m_bufferPtr; }

    ConstStringBase::SizeType getCapacity() const override { return this->m_bufferSize; }

  private:
    // ----------------------------------------------------------------------
    // Data members
    // ----------------------------------------------------------------------

    const char* m_bufferPtr;
    ConstStringBase::SizeType m_bufferSize;
};

}  // namespace Fw

#endif