MCL/sf/os/persistentdata: comparison persistentstorage/sql/SRC/Server/SqlSrvStatement.cpp

equal deleted inserted replaced

-:fa9941cf3867
+:667e88a979d7
-// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
+// Copyright (c) 2005-2010 Nokia Corporation and/or its subsidiary(-ies).
 // All rights reserved.
 // This component and the accompanying materials are made available
 // under the terms of "Eclipse Public License v1.0"
 // which accompanies this distribution, and is available
 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
 //////////////////////////////////////////////////////////////////////////////////////////////////////
 //This is the name prefix which will be given to the nameless parameters.
 //For example, if the SQL string is:
 //   SELECT * FROM A WHERE ColA1 = ? AND ColA2 = ?
-//then the names which will be give to the parameters will be:
+//then the names which will be given to the parameters will be:
 //"?0" and "?1"
 _LIT(KNamelessParameter, "?");
 /////////////////////////////////////////////////////////////////////////////////////////////////////////
 /**
 This function is called by the bound statement object to notify the current HSqlSrvStmtParamBuf object that the
 bound statement is about to be finalized. That means, when the "stream close" operation on the client side
 makes an attempt to synch the HSqlSrvStmtParamBuf object, no attempt should be made to bound the parameter data,
 because the statement object is gone.
-After this call the bound statement objects seases to exist.
+After this call the bound statement objects ceases to exist.
 Actions, performed by this method:
 - if the buffer type is "simple bind", the buffer will be destroyed. No reason to keep it alive, there is no bound IPC
 stream object on the client side;
 - if the buffer type is an IPC stream buffer and the buffer is alive, that means: the bound statement object is about to be
 	}
 /**
 Sets SQL statement parameter values.
-Only parameters, which values are set by the client, will be processed.
+Only parameters, whose values are set by the client, will be processed.
 @param aParamBuf Flat buffer with parameter values.
 @leave KErrArgument, unknown parameter type;
 	   KSqlErrStmtExpired, statement handle expired.
 	}
 /**
 Collects column names in a flat buffer and returns a reference to the buffer.
-@return A const reference to a flat buffer containing the column values.
+@return A const reference to a flat buffer containing the column names.
 @leave KErrNoMemory, an out of memory condition has occurred.
 @panic SqlDb 2 In _DEBUG mode. Invalid (not created) CSqlSrvStatement object.
 */
 	}
 /**
 Collects parameter names in a flat buffer and returns a reference to the buffer.
-@return A const reference to a flat buffer containing the column values.
+@return A const reference to a flat buffer containing the parameter names.
 @leave KErrNoMemory, an out of memory condition has occurred.
 @panic SqlDb 2 In _DEBUG mode. Invalid (not created) CSqlSrvStatement object.
 */
 /**
 This function is used by the DBMS emulation library only.
 The function retrieves the declared column types from the SQLITE library, compiles them in a single string
 and then returns the string to the caller.
-The function also initializes iColumnText8 array, where particular array element with index "idx" will
-be set to 1, if the column with index "idx" is a 8-bit text column.
 @return A pointer to a heap allocated HBufC object with the delcared column types. The caller is responsible
 		for the HBufC object destruction.
 */
 HBufC* CSqlSrvStatement::GetDeclColumnTypesL()
 	{
 		}
 	return buf;
 	}
 /**
-Creates a new HSqlSrvStmtParamBuf object.
+Creates a new HSqlSrvStmtParamBuf object for the parameter with index "aParamIndex" or
+reuses the existing one.
-@param aParameterIndex Parameter index, zero based.
+@param aParamIndex Parameter index, zero based.
 @param aDataType Parameter value type - binary, text8 or text16.
 @param aIsStreamBuf True if the param data will be retrieved from an IPC stream
 @return A pointer to the created HSqlSrvStmtParamBuf instance.
 	return paramBuf;
 	}
 /**
 This function will extend the iParamBufArray array (filling the new array items with NULL), if it is needed -
-to ensure that there is enough place for the buffer for the parameter identified by aParamIndex.
+to ensure that there is enough place in the buffer for the parameter identified by aParamIndex.
 @param aParamIndex The parameter index
 @leave KErrNoMemory, an out of memory condition has occurred;

branch	RCL_3
changeset 9	667e88a979d7
parent 0	08ec8eefde2f
child 11	211563e4b919