TSqlScalarFullSelectQuery Class Reference

class TSqlScalarFullSelectQuery

TSqlScalarFullSelectQuery interface is used for executing SELECT sql queries, which return a single row consisting of a single column value.

Examples.

CASE 1 - retrieving records count of a table:
RSqlDatabase db;
//initialize db object....
.......
TSqlScalarFullSelectQuery fullSelectQuery(db);
TInt recCnt = fullSelectQuery.SelectIntL(_L("SELECT COUNT(*) FROM PersonTbl"));
CASE 2 - retrieving specific column value using a condition in the SELECT statement:
RSqlDatabase db;
//initialize db object....
.......
TSqlScalarFullSelectQuery fullSelectQuery(db);
TInt personId = fullSelectQuery.SelectIntL(_L("SELECT ID FROM PersonTbl WHERE Name = 'John'"));
CASE 3 - retrieving a text column value, the receiving buffer is not big enough:
RSqlDatabase db;
//initialize db object....
.......
TSqlScalarFullSelectQuery fullSelectQuery(db);
HBufC* buf = HBufC::NewLC(20);
TPtr name = buf->Des();
TInt rc = fullSelectQuery.SelectTextL(_L("SELECT Name FROM PersonTbl WHERE Id = 1"), name);
TEST(rc >= 0); //the function may return only non-negative values
if(rc > 0)
	{
	buf = buf->ReAllocL(rc);
	CleanupStack::Pop();	
	CleanupStack::PushL(buf);
	name.Set(buf->Des());
	rc = fullSelectQuery.SelectTextL(_L("SELECT Name FROM PersonTbl WHERE Id = 1"), name);
	TEST(rc == 0);
	}
CleanupStack::PopAndDestroy();//buf

RSqlDatabase

Public Member Functions
TSqlScalarFullSelectQuery()
TSqlScalarFullSelectQuery(RSqlDatabase &)
IMPORT_C TIntSelectBinaryL(const TDesC &, TDes8 &)
IMPORT_C TIntSelectBinaryL(const TDesC8 &, TDes8 &)
IMPORT_C TInt64SelectInt64L(const TDesC &)
IMPORT_C TInt64SelectInt64L(const TDesC8 &)
IMPORT_C TIntSelectIntL(const TDesC &)
IMPORT_C TIntSelectIntL(const TDesC8 &)
IMPORT_C TRealSelectRealL(const TDesC &)
IMPORT_C TRealSelectRealL(const TDesC8 &)
IMPORT_C TIntSelectTextL(const TDesC &, TDes &)
IMPORT_C TIntSelectTextL(const TDesC8 &, TDes &)
IMPORT_C voidSetDatabase(RSqlDatabase &)
Private Member Functions
CSqlDatabaseImpl &Impl()
Private Attributes
CSqlDatabaseImpl *iDatabaseImpl

Constructor & Destructor Documentation

TSqlScalarFullSelectQuery()

IMPORT_CTSqlScalarFullSelectQuery()

TSqlScalarFullSelectQuery(RSqlDatabase &)

IMPORT_CTSqlScalarFullSelectQuery(RSqlDatabase &aDatabase)

Parameters

RSqlDatabase & aDatabase

Member Functions Documentation

Impl()

CSqlDatabaseImpl &Impl()const [private, inline]

SelectBinaryL(const TDesC &, TDes8 &)

IMPORT_C TIntSelectBinaryL(const TDesC &aSqlStmt,
TDes8 &aDest
)

Parameters

const TDesC & aSqlStmt
TDes8 & aDest

SelectBinaryL(const TDesC8 &, TDes8 &)

IMPORT_C TIntSelectBinaryL(const TDesC8 &aSqlStmt,
TDes8 &aDest
)

Parameters

const TDesC8 & aSqlStmt
TDes8 & aDest

SelectInt64L(const TDesC &)

IMPORT_C TInt64SelectInt64L(const TDesC &aSqlStmt)

Parameters

const TDesC & aSqlStmt

SelectInt64L(const TDesC8 &)

IMPORT_C TInt64SelectInt64L(const TDesC8 &aSqlStmt)

Parameters

const TDesC8 & aSqlStmt

SelectIntL(const TDesC &)

IMPORT_C TIntSelectIntL(const TDesC &aSqlStmt)

Parameters

const TDesC & aSqlStmt

SelectIntL(const TDesC8 &)

IMPORT_C TIntSelectIntL(const TDesC8 &aSqlStmt)

Parameters

const TDesC8 & aSqlStmt

SelectRealL(const TDesC &)

IMPORT_C TRealSelectRealL(const TDesC &aSqlStmt)

Parameters

const TDesC & aSqlStmt

SelectRealL(const TDesC8 &)

IMPORT_C TRealSelectRealL(const TDesC8 &aSqlStmt)

Parameters

const TDesC8 & aSqlStmt

SelectTextL(const TDesC &, TDes &)

IMPORT_C TIntSelectTextL(const TDesC &aSqlStmt,
TDes &aDest
)

Parameters

const TDesC & aSqlStmt
TDes & aDest

SelectTextL(const TDesC8 &, TDes &)

IMPORT_C TIntSelectTextL(const TDesC8 &aSqlStmt,
TDes &aDest
)

Parameters

const TDesC8 & aSqlStmt
TDes & aDest

SetDatabase(RSqlDatabase &)

IMPORT_C voidSetDatabase(RSqlDatabase &aDatabase)

Parameters

RSqlDatabase & aDatabase

Member Data Documentation

CSqlDatabaseImpl * iDatabaseImpl

CSqlDatabaseImpl *iDatabaseImpl[private]