#ifndef _SQMYSQL_RESULTSET_HPP_ #define _SQMYSQL_RESULTSET_HPP_ // ------------------------------------------------------------------------------------------------ #include "Handle/ResultSet.hpp" // ------------------------------------------------------------------------------------------------ namespace SqMod { /* ------------------------------------------------------------------------------------------------ * Allows management and interaction with a result set handle. */ class ResultSet { private: // -------------------------------------------------------------------------------------------- ResRef m_Handle; // Reference to the actual database result-set. protected: /* -------------------------------------------------------------------------------------------- * Validate the managed statement handle and throw an error if invalid. */ #if defined(_DEBUG) || defined(SQMOD_EXCEPTLOC) void Validate(CCStr file, Int32 line) const; #else void Validate() const; #endif // _DEBUG /* -------------------------------------------------------------------------------------------- * Validate the managed statement handle and throw an error if invalid. */ #if defined(_DEBUG) || defined(SQMOD_EXCEPTLOC) void ValidateCreated(CCStr file, Int32 line) const; #else void ValidateCreated() const; #endif // _DEBUG /* -------------------------------------------------------------------------------------------- * Validate the managed statement handle and throw an error if invalid. */ #if defined(_DEBUG) || defined(SQMOD_EXCEPTLOC) const ResRef & GetValid(CCStr file, Int32 line) const; #else const ResRef & GetValid() const; #endif // _DEBUG /* -------------------------------------------------------------------------------------------- * Validate the managed statement handle and throw an error if invalid. */ #if defined(_DEBUG) || defined(SQMOD_EXCEPTLOC) const ResRef & GetCreated(CCStr file, Int32 line) const; #else const ResRef & GetCreated() const; #endif // _DEBUG /* -------------------------------------------------------------------------------------------- * Validate the statement reference and field index, and throw an error if they're invalid. */ #if defined(_DEBUG) || defined(SQMOD_EXCEPTLOC) void ValidateField(Int32 idx, CCStr file, Int32 line) const; #else void ValidateField(Int32 idx) const; #endif // _DEBUG public: /* -------------------------------------------------------------------------------------------- * Default constructor. */ ResultSet() : m_Handle() { /* ... */ } /* -------------------------------------------------------------------------------------------- * Connection constructor. */ ResultSet(const ConnRef & conn) : m_Handle(new ResHnd()) { m_Handle->Create(conn); } /* -------------------------------------------------------------------------------------------- * Statement constructor. */ ResultSet(const StmtRef & stmt) : m_Handle(new ResHnd()) { m_Handle->Create(stmt); } /* -------------------------------------------------------------------------------------------- * Handle constructor. */ ResultSet(const ResRef & hnd) : m_Handle(hnd) { /* ... */ } /* -------------------------------------------------------------------------------------------- * Copy constructor. */ ResultSet(const ResultSet & o) = default; /* -------------------------------------------------------------------------------------------- * Move constructor. */ ResultSet(ResultSet && o) = default; /* -------------------------------------------------------------------------------------------- * Destructor. */ ~ResultSet() = default; /* -------------------------------------------------------------------------------------------- * Copy assignment operator. */ ResultSet & operator = (const ResultSet & o) = default; /* -------------------------------------------------------------------------------------------- * Move assignment operator. */ ResultSet & operator = (ResultSet && o) = default; /* -------------------------------------------------------------------------------------------- * Used by the script engine to compare two instances of this type. */ Int32 Cmp(const ResultSet & o) const { if (m_Handle.Get() == o.m_Handle.Get()) { return 0; } else if (m_Handle.Get() > o.m_Handle.Get()) { return 1; } else { return -1; } } /* -------------------------------------------------------------------------------------------- * Used by the script engine to convert an instance of this type to a string. */ CSStr ToString() const { // Do we have a valid handle? if (m_Handle) { ToStrF("%u", m_Handle->mFieldCount); } // Default to a negative value return _SC("-1"); } /* -------------------------------------------------------------------------------------------- * Used by the script engine to retrieve the name from instances of this type. */ static SQInteger Typename(HSQUIRRELVM vm); /* -------------------------------------------------------------------------------------------- * See whether the managed handle is valid. */ bool IsValid() const { return m_Handle; } /* -------------------------------------------------------------------------------------------- * Returns the current position of the row cursor for the last Next(). */ Object RowIndex() const { return MakeULongObj(SQMOD_GET_CREATED(*this)->RowIndex()); } /* -------------------------------------------------------------------------------------------- * Returns the number of rows in the result set. */ Object RowCount() const { return MakeULongObj(SQMOD_GET_CREATED(*this)->RowCount()); } /* -------------------------------------------------------------------------------------------- * Retrieve the next row from the query. */ bool Next() const { return SQMOD_GET_CREATED(*this)->Next(); } /* -------------------------------------------------------------------------------------------- * Seeks to an arbitrary row in a query result set. */ bool SetRowIndex(SQInteger index) const { return SQMOD_GET_CREATED(*this)->SetRowIndex(ConvTo< Uint64 >::From(index)); } /* -------------------------------------------------------------------------------------------- * Seeks to an arbitrary row in a query result set. */ bool SetLongRowIndex(Object & index) const { return SQMOD_GET_CREATED(*this)->SetRowIndex(FetchULongObjVal(index)); } /* -------------------------------------------------------------------------------------------- * Retrieve a signed 8 bit integer from a field. */ SQInteger GetInt8(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve an unsigned 8 bit integer from a field. */ SQInteger GetUint8(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a signed 16 bit integer from a field. */ SQInteger GetInt16(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve an unsigned 16 bit integer from a field. */ SQInteger GetUint16(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a signed 32 bit integer from a field. */ SQInteger GetInt32(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve an unsigned 32 bit integer from a field. */ SQInteger GetUint32(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a signed 64 bit integer from a field. */ Int64 GetInt64(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve an unsigned 64 bit integer from a field. */ Uint64 GetUint64(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a 32 bit floating point from a field. */ SQFloat GetFloat32(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a 64 bit floating point from a field. */ SQFloat GetFloat64(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a boolean from a field. */ bool GetBoolean(Uint32 idx) const; /* -------------------------------------------------------------------------------------------- * Retrieve a string from a field. */ CSStr GetString(Uint32 idx) const; }; } // Namespace:: SqMod #endif // _SQMYSQL_RESULTSET_HPP_