Documentation TYPO3 par Ameos

Disponible dans d'autres versions de TYPO3 -> 3.7.0  3.8.1  4.0.0  4.0.1  4.1.0   <- Available in other TYPO3 versions

ADOConnection Class Reference

Inheritance diagram for ADOConnection:[legend]List of all members.

Public Member Functions
	ADOConnection ()
	Version ()
	ServerInfo ()
	IsConnected ()
	_findvers ($str)
	outp ($msg, $newline=true)
	Time ()
	Connect ($argHostname="", $argUsername="", $argPassword="", $argDatabaseName="", $forceNew=false)
	_nconnect ($argHostname, $argUsername, $argPassword, $argDatabaseName)
	NConnect ($argHostname="", $argUsername="", $argPassword="", $argDatabaseName="")
	PConnect ($argHostname="", $argUsername="", $argPassword="", $argDatabaseName="")
	SQLDate ($fmt, $col=false)
	Prepare ($sql)
	PrepareSP ($sql, $param=true)
	Quote ($s)
	QMagic ($s)
	q (&$s)
	ErrorNative ()
	nextId ($seq_name)
	RowLock ($table, $where)
	CommitLock ($table)
	RollbackLock ($table)
	SetFetchMode ($mode)
&	Query ($sql, $inputarr=false)
&	LimitQuery ($sql, $offset, $count, $params=false)
	Disconnect ()
	Param ($name, $type='C')
	InParameter (&$stmt, &$var, $name, $maxLen=4000, $type=false)
	OutParameter (&$stmt, &$var, $name, $maxLen=4000, $type=false)
	Parameter (&$stmt, &$var, $name, $isOutput=false, $maxLen=4000, $type=false)
	IgnoreErrors ($saveErrs=false)
	StartTrans ($errfn= 'ADODB_TransMonitor')
	CompleteTrans ($autoComplete=true)
	FailTrans ()
	HasFailedTrans ()
&	Execute ($sql, $inputarr=false)
&	_Execute ($sql, $inputarr=false)
	CreateSequence ($seqname='adodbseq', $startID=1)
	DropSequence ($seqname='adodbseq')
	GenID ($seqname='adodbseq', $startID=1)
	Insert_ID ($table='', $column='')
	PO_Insert_ID ($table="", $id="")
	Affected_Rows ()
	ErrorMsg ()
	ErrorNo ()
	MetaError ($err=false)
	MetaErrorMsg ($errno)
	MetaPrimaryKeys ($table, $owner=false)
	MetaForeignKeys ($table, $owner=false, $upper=false)
	SelectDB ($dbName)
&	SelectLimit ($sql, $nrows=-1, $offset=-1, $inputarr=false, $secs2cache=0)
&	SerializableRS (&$rs)
&	_rs2rs (&$rs, $nrows=-1, $offset=-1, $close=true)
&	GetAll ($sql, $inputarr=false)
&	GetAssoc ($sql, $inputarr=false, $force_array=false, $first2cols=false)
&	CacheGetAssoc ($secs2cache, $sql=false, $inputarr=false, $force_array=false, $first2cols=false)
	GetOne ($sql, $inputarr=false)
	CacheGetOne ($secs2cache, $sql=false, $inputarr=false)
	GetCol ($sql, $inputarr=false, $trim=false)
	CacheGetCol ($secs, $sql=false, $inputarr=false, $trim=false)
&	Transpose (&$rs)
	OffsetDate ($dayFraction, $date=false)
&	GetArray ($sql, $inputarr=false)
&	CacheGetAll ($secs2cache, $sql=false, $inputarr=false)
&	CacheGetArray ($secs2cache, $sql=false, $inputarr=false)
&	GetRow ($sql, $inputarr=false)
&	CacheGetRow ($secs2cache, $sql=false, $inputarr=false)
	Replace ($table, $fieldArray, $keyCol, $autoQuote=false, $has_autoinc=false)
&	CacheSelectLimit ($secs2cache, $sql, $nrows=-1, $offset=-1, $inputarr=false)
	CacheFlush ($sql=false, $inputarr=false)
	_dirFlush ($dir, $kill_top_level=false)
	xCacheFlush ($sql=false, $inputarr=false)
	_gencachename ($sql, $createdir, $memcache=false)
&	CacheExecute ($secs2cache, $sql=false, $inputarr=false)
&	AutoExecute ($table, $fields_values, $mode= 'INSERT', $where=FALSE, $forceUpdate=true, $magicq=false)
	GetUpdateSQL (&$rs, $arrFields, $forceUpdate=false, $magicq=false, $force=null)
	GetInsertSQL (&$rs, $arrFields, $magicq=false, $force=null)
	UpdateBlob ($table, $column, $val, $where, $blobtype='BLOB')
	UpdateBlobFile ($table, $column, $path, $where, $blobtype='BLOB')
	BlobDecode ($blob)
	BlobEncode ($blob)
	SetCharSet ($charset)
	IfNull ($field, $ifNull)
	LogSQL ($enable=true)
	GetCharSet ()
	UpdateClob ($table, $column, $val, $where)
	MetaType ($t, $len=-1, $fieldobj=false)
	SetDateLocale ($locale= 'En')
&	GetActiveRecordsClass ($class, $table, $whereOrderBy=false, $bindarr=false, $primkeyArr=false)
&	GetActiveRecords ($table, $where=false, $bindarr=false, $primkeyArr=false)
	Close ()
	BeginTrans ()
	SetTransactionMode ($transaction_mode)
	MetaTransaction ($mode, $db)
	CommitTrans ($ok=true)
	RollbackTrans ()
	MetaDatabases ()
&	MetaTables ($ttype=false, $showSchema=false, $mask=false)
	_findschema (&$table, &$schema)
&	MetaColumns ($table, $normalize=true)
&	MetaIndexes ($table, $primary=false, $owner=false)
&	MetaColumnNames ($table, $numIndexes=false, $useattnum=false)
	Concat ()
	DBDate ($d)
	BindDate ($d)
	BindTimeStamp ($d)
	DBTimeStamp ($ts)
	UnixDate ($v)
	UnixTimeStamp ($v)
	UserDate ($v, $fmt='Y-m-d', $gmt=false)
	UserTimeStamp ($v, $fmt='Y-m-d H:i:s', $gmt=false)
	escape ($s, $magic_quotes=false)
	addq ($s, $magic_quotes=false)
	qstr ($s, $magic_quotes=false)
&	PageExecute ($sql, $nrows, $page, $inputarr=false, $secs2cache=0)
&	CachePageExecute ($secs2cache, $sql, $nrows, $page, $inputarr=false)
Public Attributes
	$dataProvider = 'native'
	$databaseType = ''
	$database = ''
	RDBMS currently in use, eg. odbc, mysql, mssql.
	$host = ''
	Name of database to be used.
	$user = ''
	The hostname of the database server.
	$password = ''
	The username which is used to connect to the database server.
	$debug = false
	Password for the username. For security, we no longer store it.
	$maxblobsize = 262144
	if set to true will output sql statements
	$concat_operator = '+'
	maximum size of blobs or large text fields (262144 = 256K)-- some db's die otherwise like foxpro
	$substr = 'substr'
	default concat operator -- change to || for Oracle/Interbase
	$length = 'length'
	substring operator
	$random = 'rand()'
	string length ofperator
	$upperCase = 'upper'
	random function
	$fmtDate = "'Y-m-d'"
	uppercase function
	$fmtTimeStamp = "'Y-m-d, h:i:s A'"
	used by DBDate() as the default date format used by the database
	$true = '1'
	used by DBTimeStamp as the default timestamp fmt.
	$false = '0'
	string that represents TRUE for a database
	$replaceQuote = "\\'"
	string that represents FALSE for a database
	$nameQuote = '"'
	string to use to replace quotes
	$charSet = false
	string to use to quote identifiers and names
	$metaDatabasesSQL = ''
	character set to use - only for interbase, postgres and oci8
	$metaTablesSQL = ''
	$uniqueOrderBy = false
	$emptyDate = ' '
	All order by columns have to be unique.
	$emptyTimeStamp = ' '
	$lastInsID = false
	$hasInsertID = false
	$hasAffectedRows = false
	supports autoincrement ID?
	$hasTop = false
	supports affected rows for update/delete?
	$hasLimit = false
	support mssql/access SELECT TOP 10 * FROM TABLE
	$readOnly = false
	support pgsql/mysql SELECT * FROM TABLE LIMIT 10
	$hasMoveFirst = false
	this is a readonly database - used by phpLens
	$hasGenID = false
	has ability to run MoveFirst(), scrolling backwards
	$hasTransactions = true
	can generate sequences using GenID();
	$genID = 0
	has transactions
	$raiseErrorFn = false
	sequence id used by GenID();
	$isoDates = false
	error function to call
	$cacheSecs = 3600
	accepts dates in ISO format
	$memCache = false
	cache for 1 hour
	$memCacheHost
	should we use memCache instead of caching in files
	$memCachePort = 11211
	memCache host
	$memCacheCompress = false
	memCache port
	$sysDate = false
	Use 'true' to store the item compressed (uses zlib).
	$sysTimeStamp = false
	name of function that returns the current date
	$arrayClass = 'ADORecordSet_array'
	name of function that returns the current timestamp
	$noNullStrings = false
	name of class used to generate array recordsets, which are pre-downloaded recordsets
	$numCacheHits = 0
	oracle specific stuff - if true ensures that '' is converted to ' '
	$numCacheMisses = 0
	$pageExecuteCountRows = true
	$uniqueSort = false
	$leftOuter = false
	indicates that all fields in order by must be unique
	$rightOuter = false
	operator to use for left outer join in WHERE clause
	$ansiOuter = false
	operator to use for right outer join in WHERE clause
	$autoRollback = false
	whether ansi outer join syntax supported
	$poorAffectedRows = false
	$fnExecute = false
	$fnCacheExecute = false
	$blobEncodeType = false
	$rsPrefix = "ADORecordSet_"
	$autoCommit = true
	$transOff = 0
	do not modify this yourself - actually private
	$transCnt = 0
	temporarily disable transactions
	$fetchMode = false
	count of nested transactions
	$null2null = 'null'
	$_oldRaiseFn = false
	$_transOK = null
	$_connectionID = false
	$_errorMsg = false
	The returned link identifier whenever a successful database connection is made.
	$_errorCode = false
	then returned by the errorMsg() function
	$_queryID = false
	Last error code, not guaranteed to be used - only by oci8.
	$_isPersistentConnection = false
	This variable keeps the last created result link identifier.
	$_bindInputArray = false
	A boolean variable to state whether its a persistent connection or normal connection. */.
	$_evalAll = false
	set to true if ADOConnection.Execute() permits binding of array parameters.
	$_affected = false
	$_logsql = false
	$_transmode = ''

---

Detailed Description

Connection object. For connecting to databases, and executing queries.

Definition at line 235 of file adodb.inc.php.

---

Member Function Documentation

ADOConnection::ADOConnection

(

)

Constructor

Definition at line 336 of file adodb.inc.php.

ADOConnection::ServerInfo

(

)

Get server version info...

Returns:

An array with 2 elements: $arr['string'] is the description string, and $arr[version] is the version (also a string).

Reimplemented in ADODB_ado, ADODB_ado, ADODB_borland_ibase, ADODB_db2, ADODB_firebird, ADODB_ibase, ADODB_ldap, ADODB_mysql, ADODB_oci8, ADODB_odbc, ADODB_ODBC_DB2, ADODB_odbc_mssql, ADODB_odbtp, ADODB_pdo_base, ADODB_pdo, ADODB_pdo_mssql, ADODB_pdo_mysql, ADODB_pdo_pgsql, ADODB_postgres64, ADODB_SAPDB, and ADODB_sqlite.

Definition at line 354 of file adodb.inc.php.

Referenced by ADODB_pdo_mssql::ServerInfo(), ADODB_pdo_base::ServerInfo(), ADODB_odbc::ServerInfo(), and ADODB_db2::ServerInfo().

ADOConnection::outp	(	$	msg,
		$	newline = true
	)

All error messages go through this bottleneck function. You can define your own handler by defining the function name in ADODB_OUTP.

Definition at line 374 of file adodb.inc.php.

Referenced by ADODB_odbc::_connect(), ADODB_ldap::_connect(), ADODB_db2::_connect(), ADODB_ado::_connect(), ADODB2_oci8::_CreateSuffix(), ADODB2_access::_CreateSuffix(), ADORecordSet_ado::_fetch(), _gencachename(), ADODB_DataDict::_GenFields(), ADODB_odbc::_pconnect(), ADODB_oci8::_query(), ADODB_ibase::_query(), adoSchema::addSQL(), Affected_Rows(), ADODB2_postgres::AlterColumnSQL(), ADODB2_informix::AlterColumnSQL(), ADODB2_ibase::AlterColumnSQL(), ADODB2_generic::AlterColumnSQL(), ADODB2_db2::AlterColumnSQL(), ADODB2_access::AlterColumnSQL(), AutoExecute(), ADODB_mysql::BeginTrans(), ADODB_oci8::Bind(), CacheExecute(), CacheFlush(), CacheSelectLimit(), CompleteTrans(), Connect(), ADODB2_postgres::DropColumnSQL(), ADODB2_informix::DropColumnSQL(), ADODB2_ibase::DropColumnSQL(), ADODB2_generic::DropColumnSQL(), ADODB2_db2::DropColumnSQL(), ADODB2_access::DropColumnSQL(), ADODB_Active_Record::Error(), Execute(), ADODB_DataDict::ExecuteSQLArray(), FailTrans(), GetActiveRecordsClass(), Insert_ID(), ADODB_postgres64::MetaColumns(), ADODB_pdo_pgsql::MetaColumns(), perf_mysql::optimizeTable(), adodb_perf::OptimizeTable(), ADODB_oci8::Parameter(), PConnect(), ADODB_mssqlpo::PrepareSP(), StartTrans(), ADODB_Active_Record::UpdateActiveTable(), ADODB_oci8::UpdateBlob(), ADODB_oci8::UpdateBlobFile(), and xCacheFlush().

ADOConnection::Connect	(	$	argHostname = "",
		$	argUsername = "",
		$	argPassword = "",
		$	argDatabaseName = "",
		$	forceNew = false
	)

Connect to database

Parameters:

	[argHostname]	Host to connect to
	[argUsername]	Userid to login
	[argPassword]	Associated password
	[argDatabaseName]	database
	[forceNew]	force new connection

Returns:

true or false

Definition at line 417 of file adodb.inc.php.

References _nconnect(), ErrorMsg(), ErrorNo(), and outp().

Referenced by NConnect(), and PConnect().

ADOConnection::NConnect	(	$	argHostname = "",
		$	argUsername = "",
		$	argPassword = "",
		$	argDatabaseName = ""
	)

Always force a new connection to database - currently only works with oracle

Parameters:

	[argHostname]	Host to connect to
	[argUsername]	Userid to login
	[argPassword]	Associated password
	[argDatabaseName]	database

Returns:

true or false

Definition at line 463 of file adodb.inc.php.

References Connect().

ADOConnection::PConnect	(	$	argHostname = "",
		$	argUsername = "",
		$	argPassword = "",
		$	argDatabaseName = ""
	)

Establish persistent connect to database

Parameters:

	[argHostname]	Host to connect to
	[argUsername]	Userid to login
	[argPassword]	Associated password
	[argDatabaseName]	database

Returns:

return true or false

Definition at line 478 of file adodb.inc.php.

References Connect(), ErrorMsg(), ErrorNo(), and outp().

ADOConnection::Prepare

(

$

sql

)

Should prepare the sql statement and return the stmt resource. For databases that do not support this, we return the $sql. To ensure compatibility with databases that do not support prepare:

$stmt = $db->Prepare("insert into table (id, name) values (?,?)"); $db->Execute($stmt,array(1,'Jill')) or die('insert failed'); $db->Execute($stmt,array(2,'Joe')) or die('insert failed');

Parameters:

sql

SQL to send to database

Returns:

return FALSE, or the prepared statement, or the original sql if if the database does not support prepare.

Reimplemented in ADODB_db2, ADODB_ibase, ADODB_odbc, ADODB_odbtp, and ADODB_pdo.

Definition at line 529 of file adodb.inc.php.

Referenced by Execute(), and PrepareSP().

ADOConnection::PrepareSP	(	$	sql,
		$	param = true
	)

Some databases, eg. mssql require a different function for preparing stored procedures. So we cannot use Prepare().

Should prepare the stored procedure and return the stmt resource. For databases that do not support this, we return the $sql. To ensure compatibility with databases that do not support prepare:

Parameters:

sql

SQL to send to database

Returns:

return FALSE, or the prepared statement, or the original sql if if the database does not support prepare.

Definition at line 548 of file adodb.inc.php.

References Prepare().

ADOConnection::Quote

(

$

s

)

PEAR DB Compat

Definition at line 556 of file adodb.inc.php.

References qstr().

Referenced by ADODB_SAPDB::MetaColumnNames(), ADODB_SAPDB::MetaColumns(), ADODB_SAPDB::MetaIndexes(), and ADODB_SAPDB::MetaPrimaryKeys().

ADOConnection::QMagic

(

$

s

)

Requested by "Karsten Dambekalns" <k.dambekalns@fishfarm.de>

Definition at line 564 of file adodb.inc.php.

References qstr().

ADOConnection::ErrorNative

(

)

PEAR DB Compat - do not use internally.

Definition at line 578 of file adodb.inc.php.

References ErrorNo().

ADOConnection::nextId

(

$

seq_name

)

PEAR DB Compat - do not use internally.

Definition at line 587 of file adodb.inc.php.

References GenID().

ADOConnection::RowLock	(	$	table,
		$	where
	)

Lock a row, will escalate and lock the table if row locking not supported will normally free the lock at the end of the transaction

Parameters:

	$table	name of table to lock
	$where	where clause to use, eg: "WHERE row=12". If left empty, will escalate to table lock

Definition at line 599 of file adodb.inc.php.

ADOConnection::SetFetchMode

(

$

mode

)

PEAR DB Compat - do not use internally.

The fetch modes for NUMERIC and ASSOC for PEAR DB and ADODB are identical for easy porting :-)

Parameters:

mode

The fetchmode ADODB_FETCH_ASSOC or ADODB_FETCH_NUM

Returns:

The previous fetch mode

Definition at line 623 of file adodb.inc.php.

Referenced by GetActiveRecordsClass(), ADODB_sqlite::MetaColumns(), ADODB_SAPDB::MetaColumns(), ADODB_postgres64::MetaColumns(), ADODB_pdo_pgsql::MetaColumns(), ADODB_pdo_oci::MetaColumns(), ADODB_pdo_mysql::MetaColumns(), ADODB_odbtp::MetaColumns(), ADODB_oci8::MetaColumns(), ADODB_netezza::MetaColumns(), ADODB_mysql::MetaColumns(), MetaColumns(), MetaDatabases(), ADODB_sqlite::MetaIndexes(), ADODB_SAPDB::MetaIndexes(), ADODB_postgres64::MetaIndexes(), ADODB_odbc_mssql::MetaIndexes(), ADODB_ODBC_DB2::MetaIndexes(), ADODB_oci8::MetaIndexes(), ADODB_mysql::MetaIndexes(), ADODB_ibase::MetaIndexes(), ADODB_odbtp::MetaTables(), and MetaTables().

& ADOConnection::Query	(	$	sql,
		$	inputarr = false
	)

PEAR DB Compat - do not use internally.

Definition at line 639 of file adodb.inc.php.

References Execute().

& ADOConnection::LimitQuery	(	$	sql,
		$	offset,
		$	count,
		$	params = false
	)

PEAR DB Compat - do not use internally

Definition at line 650 of file adodb.inc.php.

References SelectLimit().

ADOConnection::Disconnect

(

)

PEAR DB Compat - do not use internally

Definition at line 661 of file adodb.inc.php.

References Close().

ADOConnection::StartTrans

(

$

errfn = 'ADODB_TransMonitor'

)

Improved method of initiating a transaction. Used together with CompleteTrans(). Advantages include:

a. StartTrans/CompleteTrans is nestable, unlike BeginTrans/CommitTrans/RollbackTrans. Only the outermost block is treated as a transaction.
b. CompleteTrans auto-detects SQL errors, and will rollback on errors, commit otherwise.
c. All BeginTrans/CommitTrans/RollbackTrans inside a StartTrans/CompleteTrans block are disabled, making it backward compatible.

Definition at line 740 of file adodb.inc.php.

References BeginTrans(), and outp().

ADOConnection::CompleteTrans

(

$

autoComplete = true

)

Used together with StartTrans() to end a transaction. Monitors connection for sql errors, and will commit or rollback as appropriate.

if true, monitor sql errors and commit and rollback as appropriate, and if set to false force rollback even if no SQL error detected.

Returns:

true on commit, false on rollback.

Definition at line 765 of file adodb.inc.php.

References CommitTrans(), outp(), and RollbackTrans().

ADOConnection::HasFailedTrans

(

)

Check if transaction has failed, only for Smart Transactions.

Definition at line 807 of file adodb.inc.php.

& ADOConnection::Execute	(	$	sql,
		$	inputarr = false
	)

Execute SQL

Parameters:

	sql	SQL statement to execute, or possibly an array holding prepared statement ($sql[0] will hold sql text)
	[inputarr]	holds the input data to bind to. Null elements will be set to null.

Returns:

RecordSet or false

Reimplemented in ADODB_oci8.

Definition at line 820 of file adodb.inc.php.

References _Execute(), outp(), Prepare(), and qstr().

Referenced by ADODB_postgres64::_connect(), ADODB_odbc_oracle::_connect(), ADODB_odbc::_connect(), ADODB_db2::_connect(), ADODB_odbc_oracle::_pconnect(), ADODB_odbc::_pconnect(), ADODB_db2::_pconnect(), AutoExecute(), ADODB_sybase::BeginTrans(), ADODB_sqlite::BeginTrans(), ADODB_mysqlt::BeginTrans(), CacheExecute(), ADODB_sybase::CommitTrans(), ADODB_sqlite::CommitTrans(), ADODB_mysqlt::CommitTrans(), ADODB_sqlanywhere::create_blobvar(), ADODB_sqlite::CreateSequence(), ADODB_odbtp::CreateSequence(), ADODB_odbc::CreateSequence(), ADODB_mysql::CreateSequence(), ADODB_ibase::CreateSequence(), ADODB_db2::CreateSequence(), ADODB_ado_mssql::CreateSequence(), CreateSequence(), ADODB_sqlanywhere::drop_blobvar(), ADODB_sqlite::DropSequence(), ADODB_odbtp::DropSequence(), ADODB_odbc::DropSequence(), ADODB_ibase::DropSequence(), ADODB_db2::DropSequence(), DropSequence(), ADODB_sqlite::GenID(), ADODB_odbtp::GenID(), ADODB_odbc::GenID(), ADODB_mysql::GenID(), ADODB_ibase::GenID(), ADODB_ado_mssql::GenID(), GenID(), GetArray(), GetAssoc(), GetCol(), GetOne(), GetRow(), ADODB_sqlanywhere::load_blobvar_from_file(), ADODB_sqlanywhere::load_blobvar_from_var(), ADODB_sybase_ase::MetaColumns(), ADODB_sqlite::MetaColumns(), ADODB_postgres64::MetaColumns(), ADODB_pdo_pgsql::MetaColumns(), ADODB_pdo_oci::MetaColumns(), ADODB_pdo_mysql::MetaColumns(), ADODB_odbtp::MetaColumns(), ADODB_odbc_oracle::MetaColumns(), ADODB_netezza::MetaColumns(), ADODB_mysql::MetaColumns(), ADODB_ibase::MetaColumns(), ADODB_fbsql::MetaColumns(), MetaColumns(), ADODB_sybase_ase::MetaDatabases(), ADODB_postgres7::MetaForeignKeys(), ADODB_sqlite::MetaIndexes(), ADODB_SAPDB::MetaIndexes(), ADODB_postgres64::MetaIndexes(), ADODB_odbc_mssql::MetaIndexes(), ADODB_ODBC_DB2::MetaIndexes(), ADODB_mysql::MetaIndexes(), ADODB_ibase::MetaIndexes(), ADODB_sybase_ase::MetaTables(), ADODB_odbc_oracle::MetaTables(), MetaTables(), ADODB_ibase::OldUpdateBlob(), Query(), ADODB_sybase::RollbackTrans(), ADODB_sqlite::RollbackTrans(), ADODB_mysqlt::RollbackTrans(), ADODB_mysqlt::RowLock(), ADODB_ibase::RowLock(), ADODB_sybase::SelectLimit(), ADODB_sqlite::SelectLimit(), ADODB_postgres7::SelectLimit(), ADODB_pdo_pgsql::SelectLimit(), ADODB_pdo_mysql::SelectLimit(), ADODB_odbc_mssql::SelectLimit(), ADODB_ODBC_DB2::SelectLimit(), ADODB_mysql::SelectLimit(), ADODB_firebird::SelectLimit(), ADODB_borland_ibase::SelectLimit(), SelectLimit(), ADODB_pdo_mysql::SetTransactionMode(), ADODB_pdo_mssql::SetTransactionMode(), ADODB_odbc_mssql::SetTransactionMode(), ADODB_mysqlt::SetTransactionMode(), ADODB_ado_mssql::SetTransactionMode(), ADODB_sqlanywhere::UpdateBlob(), ADODB_postgres64::UpdateBlob(), ADODB_odbc::UpdateBlob(), ADODB_ibase::UpdateBlob(), ADODB_db2::UpdateBlob(), UpdateBlob(), and ADODB_ibase::UpdateBlobFile().

ADOConnection::GenID	(	$	seqname = 'adodbseq',
		$	startID = 1
	)

Generates a sequence id and stores it in $this->genID; GenID is only available if $this->hasGenID = true;

Parameters:

	seqname	name of sequence to use
	startID	if sequence does not exist, start at this ID

Returns:

0 if not supported, otherwise a sequence id

Reimplemented in ADODB_ado_mssql, ADODB_db2, ADODB_ibase, ADODB_mysql, ADODB_odbc, ADODB_odbtp, and ADODB_sqlite.

Definition at line 965 of file adodb.inc.php.

References Execute().

Referenced by nextId().

ADOConnection::Insert_ID	(	$	table = '',
		$	column = ''
	)

Parameters:

	$table	string name of the table, not needed by all databases (eg. mysql), default ''
	$column	string name of the column, not needed by all databases (eg. mysql), default ''

Returns:

the last inserted ID. Not all databases support this.

Definition at line 998 of file adodb.inc.php.

References outp().

Referenced by PO_Insert_ID().

ADOConnection::PO_Insert_ID	(	$	table = "",
		$	id = ""
	)

Portable Insert ID. Pablo Roca <pabloroca::mvps.org>

Returns:

the last inserted ID. All databases support this. But aware possible problems in multiuser environments. Heavy test this before deploying.

Definition at line 1016 of file adodb.inc.php.

References GetOne(), and Insert_ID().

ADOConnection::Affected_Rows

(

)

Returns:

# rows affected by UPDATE/DELETE

Definition at line 1028 of file adodb.inc.php.

References outp().

ADOConnection::ErrorMsg

(

)

Returns:

the last error message

Reimplemented in ADODB_ado, ADODB_ado, ADODB_csv, ADODB_db2, ADODB_fbsql, ADODB_ibase, ADODB_mysql, ADODB_oci8, ADODB_odbc, ADODB_odbtp, ADODB_oracle, ADODB_pdo, ADODB_postgres64, ADODB_sqlite, ADODB_sybase, and ADODB_sybase_ase.

Definition at line 1046 of file adodb.inc.php.

Referenced by _Execute(), Connect(), ADODB_odbc::ErrorMsg(), ADODB_db2::ErrorMsg(), GetActiveRecordsClass(), and PConnect().

ADOConnection::ErrorNo

(

)

Returns:

the last error number. Normally 0 means no error.

Reimplemented in ADODB_ado, ADODB_ado, ADODB_csv, ADODB_db2, ADODB_fbsql, ADODB_ibase, ADODB_mysql, ADODB_oci8, ADODB_odbc, ADODB_odbtp, ADODB_oracle, ADODB_pdo, ADODB_postgres64, and ADODB_sqlite.

Definition at line 1056 of file adodb.inc.php.

Referenced by _Execute(), Connect(), ErrorNative(), ADODB_odbc::ErrorNo(), ADODB_db2::ErrorNo(), MetaError(), and PConnect().

ADOConnection::MetaPrimaryKeys	(	$	table,
		$	owner = false
	)

Returns:

an array with the primary key columns in it.

Reimplemented in ADODB_odbtp.

Definition at line 1077 of file adodb.inc.php.

References MetaColumns().

ADOConnection::MetaForeignKeys	(	$	table,
		$	owner = false,
		$	upper = false
	)

Returns:

assoc array where keys are tables, and values are foreign keys

Reimplemented in ADODB_odbc_mssql, ADODB_odbtp, and ADODB_postgres7.

Definition at line 1097 of file adodb.inc.php.

ADOConnection::SelectDB

(

$

dbName

)

Choose a database to connect to. Many databases do not support this.

Parameters:

dbName

is the name of the database to select

Returns:

true or false

Reimplemented in ADODB_fbsql, ADODB_ibase, ADODB_ldap, ADODB_mysql, ADODB_oci8, ADODB_odbtp, and ADODB_sybase.

Definition at line 1107 of file adodb.inc.php.

Referenced by ADODB_pdo_mysql::MetaColumns().

& ADOConnection::SelectLimit	(	$	sql,
		$	nrows = -1,
		$	offset = -1,
		$	inputarr = false,
		$	secs2cache = 0
	)

Will select, getting rows from $offset (1-based), for $nrows. This simulates the MySQL "select * from table limit $offset,$nrows" , and the PostgreSQL "select * from table limit $nrows offset $offset". Note that MySQL and PostgreSQL parameter ordering is the opposite of the other. eg. SelectLimit('select * from table',3); will return rows 1 to 3 (1-based) SelectLimit('select * from table',3,2); will return rows 3 to 5 (1-based)

Uses SELECT TOP for Microsoft databases (when $this->hasTop is set) BUG: Currently SelectLimit fails with $sql with LIMIT or TOP clause already set

Parameters:

	sql
	[offset]	is the row to start calculations from (1-based)
	[nrows]	is the number of rows to get
	[inputarr]	array of bind variables
	[secs2cache]	is a private parameter only used by jlim

Returns:

the recordset ($rs->databaseType == 'array')

Reimplemented in ADODB_borland_ibase, ADODB_firebird, ADODB_mysql, ADODB_oci8, ADODB_oci805, ADODB_odbc_mssql, ADODB_odbtp, ADODB_pdo_base, ADODB_pdo, ADODB_pdo_mssql, ADODB_pdo_mysql, ADODB_pdo_pgsql, ADODB_postgres7, ADODB_sqlite, ADODB_sybase, and ADODB_vfp.

Definition at line 1130 of file adodb.inc.php.

References _rs2rs(), CacheExecute(), and Execute().

Referenced by AutoExecute(), CacheSelectLimit(), LimitQuery(), ADODB_vfp::SelectLimit(), ADODB_sybase::SelectLimit(), ADODB_pdo_mssql::SelectLimit(), ADODB_pdo_base::SelectLimit(), ADODB_odbtp::SelectLimit(), ADODB_odbc_mssql::SelectLimit(), ADODB_ODBC_DB2::SelectLimit(), ADODB_oci805::SelectLimit(), and ADODB_oci8::SelectLimit().

& ADOConnection::SerializableRS

(

&$

rs

)

Create serializable recordset. Breaks rs link to connection.

Parameters:

rs

the recordset to serialize

Definition at line 1198 of file adodb.inc.php.

References _rs2rs().

& ADOConnection::_rs2rs	(	&$	rs,
		$	nrows = -1,
		$	offset = -1,
		$	close = true
	)

Convert database recordset to an array recordset input recordset's cursor should be at beginning, and old $rs will be closed.

Parameters:

	rs	the recordset to copy
	[nrows]	number of rows to retrieve (optional)
	[offset]	offset by number of rows (optional)

Returns:

the new recordset

Definition at line 1217 of file adodb.inc.php.

References $arrayClass, and $false.

Referenced by _Execute(), CacheExecute(), SelectLimit(), SerializableRS(), and Transpose().

ADOConnection::GetOne	(	$	sql,
		$	inputarr = false
	)

Return first element of first row of sql statement. Recordset is disposed for you.

Parameters:

	sql	SQL statement
	[inputarr]	input bind array

Reimplemented in ADODB_mysql.

Definition at line 1295 of file adodb.inc.php.

References Execute().

Referenced by ADODB_sybase::_affectedrows(), ADODB_ado_mssql::_affectedrows(), ADODB_sybase::_insertid(), ADODB_sqlanywhere::_insertid(), ADODB_SAPDB::_insertid(), ADODB_postgres64::_insertid(), ADODB_odbtp::_insertid(), ADODB_odbc_mssql::_insertid(), ADODB_ODBC_DB2::_insertid(), ADODB_mysql::_insertid(), ADODB_db2::_insertid(), ADODB_ado_mssql::_insertid(), ADODB_odbtp::CreateSequence(), ADODB_sqlite::GenID(), ADODB_odbtp::GenID(), ADODB_odbc::GenID(), ADODB_db2::GenID(), ADODB_ado_mssql::GenID(), ADODB_mysql::GetOne(), PO_Insert_ID(), ADODB_sybase::RowLock(), ADODB_postgres64::RowLock(), ADODB_ODBC_DB2::RowLock(), ADODB_oci8::RowLock(), ADODB_postgres64::ServerInfo(), ADODB_pdo_pgsql::ServerInfo(), ADODB_pdo_mysql::ServerInfo(), ADODB_ODBC_DB2::ServerInfo(), ADODB_oci8::ServerInfo(), and ADODB_mysql::ServerInfo().

& ADOConnection::GetArray	(	$	sql,
		$	inputarr = false
	)

Parameters:

	sql	SQL statement
	[inputarr]	input bind array

Definition at line 1395 of file adodb.inc.php.

References $false, and Execute().

Referenced by GetAll(), ADODB_odbtp::MetaForeignKeys(), ADODB_odbc_mssql::MetaForeignKeys(), ADODB_oci8::MetaForeignKeys(), ADODB_odbtp::MetaPrimaryKeys(), ADODB_sybase_ase::MetaTables(), and ADODB_odbtp::MetaTables().

& ADOConnection::GetRow	(	$	sql,
		$	inputarr = false
	)

Return one row of sql statement. Recordset is disposed for you.

Parameters:

	sql	SQL statement
	[inputarr]	input bind array

Definition at line 1452 of file adodb.inc.php.

References $false, and Execute().

Referenced by ADODB_odbc_mssql::ServerInfo().

ADOConnection::Replace	(	$	table,
		$	fieldArray,
		$	keyCol,
		$	autoQuote = false,
		$	has_autoinc = false
	)

Insert or replace a single record. Note: this is not the same as MySQL's replace. ADOdb's Replace() uses update-insert semantics, not insert-delete-duplicates of MySQL. Also note that no table locking is done currently, so it is possible that the record be inserted twice by two programs...

$this->Replace('products', array('prodname' =>"'Nails'","price" => 3.99), 'prodname');

$table table name $fieldArray associative array of data (you must quote strings yourself). $keyCol the primary key field name or if compound key, array of field names autoQuote set to true to use a hueristic to quote strings. Works with nulls and numbers but does not work with dates nor SQL functions. has_autoinc the primary key is an auto-inc field, so skip in insert.

Currently blob replace not supported

returns 0 = fail, 1 = update, 2 = insert

Definition at line 1505 of file adodb.inc.php.

& ADOConnection::CacheSelectLimit	(	$	secs2cache,
		$	sql,
		$	nrows = -1,
		$	offset = -1,
		$	inputarr = false
	)

Will select, getting rows from $offset (1-based), for $nrows. This simulates the MySQL "select * from table limit $offset,$nrows" , and the PostgreSQL "select * from table limit $nrows offset $offset". Note that MySQL and PostgreSQL parameter ordering is the opposite of the other. eg. CacheSelectLimit(15,'select * from table',3); will return rows 1 to 3 (1-based) CacheSelectLimit(15,'select * from table',3,2); will return rows 3 to 5 (1-based)

BUG: Currently CacheSelectLimit fails with $sql with LIMIT or TOP clause already set

Parameters:

	[secs2cache]	seconds to cache data, set to 0 to force query. This is optional
	sql
	[offset]	is the row to start calculations from (1-based)
	[nrows]	is the number of rows to get
	[inputarr]	array of bind variables

Returns:

the recordset ($rs->databaseType == 'array')

Definition at line 1532 of file adodb.inc.php.

References outp(), and SelectLimit().

ADOConnection::CacheFlush	(	$	sql = false,
		$	inputarr = false
	)

Flush cached recordsets that match a particular $sql statement. If $sql == false, then we purge all files in the cache.

Definition at line 1556 of file adodb.inc.php.

References _dirFlush(), _gencachename(), and outp().

ADOConnection::_dirFlush	(	$	dir,
		$	kill_top_level = false
	)

Private function to erase all of the files and subdirectories in a directory.

Just specify the directory, and tell it if you want to delete the directory or just clear it out. Note: $kill_top_level is used internally in the function to flush subdirectories.

Definition at line 1600 of file adodb.inc.php.

Referenced by CacheFlush().

ADOConnection::_gencachename	(	$	sql,
		$	createdir,
		$	memcache = false
	)

Private function to generate filename for caching. Filename is generated based on:

• sql statement
• database type (oci8, ibase, ifx, etc)
• database name
• userid
• setFetchMode (adodb 4.23)

When not in safe mode, we create 256 sub-directories in the cache directory ($ADODB_CACHE_DIR). Assuming that we can have 50,000 files per directory with good performance, then we can scale to 12.8 million unique cached recordsets. Wow!

Definition at line 1669 of file adodb.inc.php.

References outp().

Referenced by CacheExecute(), CacheFlush(), and xCacheFlush().

& ADOConnection::CacheExecute	(	$	secs2cache,
		$	sql = false,
		$	inputarr = false
	)

Execute SQL, caching recordsets.

Parameters:

	[secs2cache]	seconds to cache data, set to 0 to force query. This is an optional parameter.
	sql	SQL statement to execute
	[inputarr]	holds the input data to bind to

Returns:

RecordSet or false

Definition at line 1705 of file adodb.inc.php.

References _gencachename(), _rs2rs(), Execute(), and outp().

Referenced by CacheGetArray(), CacheGetAssoc(), CacheGetCol(), CacheGetOne(), CacheGetRow(), ADODB_sqlite::SelectLimit(), ADODB_postgres7::SelectLimit(), ADODB_pdo_pgsql::SelectLimit(), ADODB_pdo_mysql::SelectLimit(), ADODB_oci8::SelectLimit(), ADODB_mysql::SelectLimit(), ADODB_firebird::SelectLimit(), ADODB_borland_ibase::SelectLimit(), and SelectLimit().

ADOConnection::GetUpdateSQL	(	&$	rs,
		$	arrFields,
		$	forceUpdate = false,
		$	magicq = false,
		$	force = null
	)

Generates an Update Query based on an existing recordset. $arrFields is an associative array of fields with the value that should be assigned.

Note: This function should only be used on a recordset that is run against a single table and sql should only be a simple select stmt with no groupby/orderby/limit

"Jonathan Younger" <jyounger@unilab.com>

Definition at line 1859 of file adodb.inc.php.

Referenced by AutoExecute().

ADOConnection::GetInsertSQL	(	&$	rs,
		$	arrFields,
		$	magicq = false,
		$	force = null
	)

Generates an Insert Query based on an existing recordset. $arrFields is an associative array of fields with the value that should be assigned.

Note: This function should only be used on a recordset that is run against a single table.

Definition at line 1884 of file adodb.inc.php.

Referenced by AutoExecute().

ADOConnection::UpdateBlob	(	$	table,
		$	column,
		$	val,
		$	where,
		$	blobtype = 'BLOB'
	)

Update a blob column, given a where clause. There are more sophisticated blob handling functions that we could have implemented, but all require a very complex API. Instead we have chosen something that is extremely simple to understand and use.

Note: $blobtype supports 'BLOB' and 'CLOB', default is BLOB of course.

Usage to update a $blobvalue which has a primary key blob_id=1 into a field blobtable.blobcolumn:

UpdateBlob('blobtable', 'blobcolumn', $blobvalue, 'blob_id=1');

Insert example:

$conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)'); $conn->UpdateBlob('blobtable','blobcol',$blob,'id=1');

Reimplemented in ADODB_db2, ADODB_ibase, ADODB_oci8, ADODB_odbc, ADODB_odbtp, and ADODB_postgres64.

Definition at line 1916 of file adodb.inc.php.

References Execute().

Referenced by ADODB_postgres64::UpdateBlobFile(), UpdateBlobFile(), and UpdateClob().

ADOConnection::UpdateBlobFile	(	$	table,
		$	column,
		$	path,
		$	where,
		$	blobtype = 'BLOB'
	)

Usage: UpdateBlob('TABLE', 'COLUMN', '/path/to/file', 'ID=1');

$blobtype supports 'BLOB' and 'CLOB'

$conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)'); $conn->UpdateBlob('blobtable','blobcol',$blobpath,'id=1');

Reimplemented in ADODB_ibase, ADODB_oci8, and ADODB_postgres64.

Definition at line 1930 of file adodb.inc.php.

References UpdateBlob().

ADOConnection::UpdateClob	(	$	table,
		$	column,
		$	val,
		$	where
	)

Usage: UpdateClob('TABLE', 'COLUMN', $var, 'ID=1', 'CLOB');

$conn->Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, null)'); $conn->UpdateClob('clobtable','clobcol',$clob,'id=1');

Definition at line 1984 of file adodb.inc.php.

References UpdateBlob().

ADOConnection::SetDateLocale

(

$

locale = 'En'

)

Change the SQL connection locale to a specified locale. This is used to get the date formats written depending on the client locale.

Definition at line 2007 of file adodb.inc.php.

ADOConnection::Close

(

)

Close Connection

Definition at line 2088 of file adodb.inc.php.

Referenced by Disconnect().

ADOConnection::BeginTrans

(

)

Begin a Transaction. Must be followed by CommitTrans() or RollbackTrans().

Returns:

true if succeeded or false if database does not support transactions

Reimplemented in ADODB_access, ADODB_ado, ADODB_ado, ADODB_ado_access, ADODB_borland_ibase, ADODB_db2, ADODB_ibase, ADODB_mysql, ADODB_mysqlt, ADODB_oci8, ADODB_odbc, ADODB_odbtp, ADODB_oracle, ADODB_pdo, ADODB_postgres64, ADODB_sqlite, ADODB_sybase, and ADODB_vfp.

Definition at line 2100 of file adodb.inc.php.

Referenced by StartTrans().

ADOConnection::CommitTrans

(

$

ok = true

)

If database does not support transactions, always return true as data always commited

Parameters:

$ok

set to false to rollback transaction, true to commit

Returns:

true/false.

Reimplemented in ADODB_ado, ADODB_ado, ADODB_db2, ADODB_ibase, ADODB_mysqlt, ADODB_oci8, ADODB_odbc, ADODB_odbtp, ADODB_oracle, ADODB_pdo, ADODB_postgres64, ADODB_sqlite, and ADODB_sybase.

Definition at line 2161 of file adodb.inc.php.

Referenced by CommitLock(), and CompleteTrans().

ADOConnection::RollbackTrans

(

)

If database does not support transactions, rollbacks always fail, so return false

Returns:

true/false.

Reimplemented in ADODB_ado, ADODB_ado, ADODB_ado_access, ADODB_db2, ADODB_ibase, ADODB_mysqlt, ADODB_oci8, ADODB_odbc, ADODB_odbtp, ADODB_oracle, ADODB_pdo, ADODB_postgres64, ADODB_sqlite, and ADODB_sybase.

Definition at line 2170 of file adodb.inc.php.

Referenced by ADODB_mysql::_pconnect(), CompleteTrans(), and RollbackLock().

ADOConnection::MetaDatabases

(

)

return the databases that the driver can connect to. Some databases will return an empty array.

Returns:

an array of database names.

Reimplemented in ADODB_csv, ADODB_fbsql, ADODB_mysql, and ADODB_sybase_ase.

Definition at line 2180 of file adodb.inc.php.

References GetCol(), and SetFetchMode().

& ADOConnection::MetaTables	(	$	ttype = false,
		$	showSchema = false,
		$	mask = false
	)

Parameters:

	ttype	can either be 'VIEW' or 'TABLE' or false. If false, both views and tables are returned. "VIEW" returns only views "TABLE" returns only tables
	showSchema	returns the schema/user with the table name, eg. USER.TABLE
	mask	is the input mask - only supported by oci8 and postgresql

Returns:

array of tables for current database.

Reimplemented in ADODB_mysql, ADODB_oci8, ADODB_odbc_mssql, ADODB_odbtp, ADODB_pdo, ADODB_pdo_mysql, ADODB_pdo_oci, ADODB_pdo_pgsql, ADODB_postgres64, and ADODB_sybase_ase.

Definition at line 2211 of file adodb.inc.php.

References $false, Execute(), and SetFetchMode().

Referenced by ADODB_postgres64::MetaTables(), ADODB_pdo_pgsql::MetaTables(), ADODB_pdo_oci::MetaTables(), ADODB_pdo_mysql::MetaTables(), ADODB_odbc_mssql::MetaTables(), ADODB_oci8::MetaTables(), and ADODB_mysql::MetaTables().

& ADOConnection::MetaColumns	(	$	table,
		$	normalize = true
	)

List columns in a database as an array of ADOFieldObjects. See top of file for definition of object.

Parameters:

	$table	table name to query
	$normalize	makes table name case-insensitive (required by some databases) is optional database schema to use - not supported by all databases.

Returns:

array of ADOFieldObjects for current table.

Reimplemented in ADODB_netezza, ADODB_odbtp, ADODB_pdo, ADODB_pdo_pgsql, ADODB_postgres64, and ADODB_sybase_ase.

Definition at line 2273 of file adodb.inc.php.

References $false, _findschema(), Execute(), and SetFetchMode().

Referenced by MetaColumnNames(), ADODB_odbc_mssql::MetaColumns(), and MetaPrimaryKeys().

& ADOConnection::MetaIndexes	(	$	table,
		$	primary = false,
		$	owner = false
	)

List indexes on a table as an array.

Parameters:

	table	table name to query
	primary	true to only show primary keys. Not actually used for most databases

Returns:

array of indexes on current table. Each element represents an index, and is itself an associative array.

Array ( [name_of_index] => Array ( [unique] => true or false [columns] => Array ( [0] => firstname [1] => lastname ) )

Reimplemented in ADODB_ibase, ADODB_mysql, ADODB_oci8, ADODB_ODBC_DB2, and ADODB_sqlite.

Definition at line 2332 of file adodb.inc.php.

References $false.

& ADOConnection::MetaColumnNames	(	$	table,
		$	numIndexes = false,
		$	useattnum = false
	)

List columns names in a table as an array.

Parameters:

table

table name to query

Returns:

array of column names for current table.

Definition at line 2344 of file adodb.inc.php.

References $false, and MetaColumns().

Referenced by ADODB_postgres64::MetaIndexes().

ADOConnection::Concat

(

)

Different SQL databases used different methods to combine strings together. This function provides a wrapper.

param s variable number of string parameters

Usage: $db->Concat($str1,$str2);

Returns:

concatenated string

Reimplemented in ADODB_fbsql, and ADODB_mysql.

Definition at line 2376 of file adodb.inc.php.

ADOConnection::DBDate

(

$

d

)

Converts a date "d" to a string that the database can understand.

Parameters:

d

a date in Unix date time format.

Returns:

date string in database date format

Reimplemented in ADODB_oci8, and ADODB_oracle.

Definition at line 2390 of file adodb.inc.php.

References UnixDate().

Referenced by ADODB_oracle::BindDate(), ADODB_oci8::BindDate(), and BindDate().

ADOConnection::DBTimeStamp

(

$

ts

)

Converts a timestamp "ts" to a string that the database can understand.

Parameters:

ts

a timestamp in Unix date time format.

Returns:

timestamp string in database timestamp format

Reimplemented in ADODB_db2, ADODB_oci8, and ADODB_oracle.

Definition at line 2427 of file adodb.inc.php.

References UnixTimeStamp().

Referenced by ADODB_oracle::BindTimeStamp(), ADODB_oci8::BindTimeStamp(), and BindTimeStamp().

ADOConnection::UnixDate

(

$

v

)

Also in ADORecordSet.

Parameters:

$v

is a date string in YYYY-MM-DD format

Returns:

date in unix timestamp format, or 0 if before TIMESTAMP_FIRST_YEAR, or false if invalid date format

Reimplemented in ADODB_sybase.

Definition at line 2448 of file adodb.inc.php.

Referenced by DBDate(), ADORecordSet::UnixDate(), and UserDate().

ADOConnection::UnixTimeStamp

(

$

v

)

Also in ADORecordSet.

Parameters:

$v

is a timestamp string in YYYY-MM-DD HH-NN-SS format

Returns:

date in unix timestamp format, or 0 if before TIMESTAMP_FIRST_YEAR, or false if invalid date format

Reimplemented in ADODB_sybase.

Definition at line 2472 of file adodb.inc.php.

Referenced by DBTimeStamp(), ADODB_pdo::Time(), ADODB_oci8::Time(), Time(), ADORecordSet::UnixTimeStamp(), and UserTimeStamp().

ADOConnection::UserDate	(	$	v,
		$	fmt = 'Y-m-d',
		$	gmt = false
	)

Also in ADORecordSet.

Format database date based on user defined format.

Parameters:

	v	is the character date in YYYY-MM-DD format, returned by database
	fmt	is the format to apply to it, using date()

Returns:

a date formated as user desires

Definition at line 2502 of file adodb.inc.php.

References UnixDate().

ADOConnection::UserTimeStamp	(	$	v,
		$	fmt = 'Y-m-d H:i:s',
		$	gmt = false
	)

Parameters:

	v	is the character timestamp in YYYY-MM-DD hh:mm:ss format
	fmt	is the format to apply to it, using date()

Returns:

a timestamp formated as user desires

Definition at line 2523 of file adodb.inc.php.

References UnixTimeStamp().

ADOConnection::addq	(	$	s,
		$	magic_quotes = false
	)

Quotes a string, without prefixing nor appending quotes.

Definition at line 2543 of file adodb.inc.php.

Referenced by escape().

ADOConnection::qstr	(	$	s,
		$	magic_quotes = false
	)

Correctly quotes a string so that all strings are escaped. We prefix and append to the string single-quotes. An example is $db->qstr("Don't bother",magic_quotes_runtime());

Parameters:

	s	the string to quote
	[magic_quotes]	if $s is GET/POST var, set to get_magic_quotes_gpc(). This undoes the stupidity of magic quotes for GPC.

Returns:

quoted string to be sent back to database

Reimplemented in ADODB_mysql, ADODB_oci8, ADODB_postgres64, and ADODB_vfp.

Definition at line 2577 of file adodb.inc.php.

Referenced by ADODB_csv::_Execute(), Execute(), ADODB_sqlanywhere::load_blobvar_from_file(), ADODB_sqlanywhere::load_blobvar_from_var(), ADODB_odbc_mssql::MetaForeignKeys(), ADODB_odbc_mssql::MetaIndexes(), ADODB_pdo_pgsql::MetaTables(), ADODB_pdo_oci::MetaTables(), ADODB_pdo_mysql::MetaTables(), ADODB_odbc_mssql::MetaTables(), q(), QMagic(), Quote(), ADODB_sybase::SQLDate(), ADODB_sqlite::SQLDate(), ADODB_odbc_mssql::SQLDate(), ADODB_ODBC_DB2::SQLDate(), ADODB_ibase::SQLDate(), and ADODB_db2::SQLDate().

& ADOConnection::PageExecute	(	$	sql,
		$	nrows,
		$	page,
		$	inputarr = false,
		$	secs2cache = 0
	)

Will select the supplied $page number from a recordset, given that it is paginated in pages of $nrows rows per page. It also saves two boolean values saying if the given page is the first and/or last one of the recordset. Added by Iván Oliva to provide recordset pagination.

See readme.htm::ex8 for an example of usage.

Parameters:

	sql
	nrows	is the number of rows per page to get
	page	is the page number to get (1-based)
	[inputarr]	array of bind variables
	[secs2cache]	is a private parameter only used by jlim

Returns:

the recordset ($rs->databaseType == 'array')

NOTE: phpLens uses a different algorithm and does not use PageExecute().

Definition at line 2618 of file adodb.inc.php.

Referenced by CachePageExecute().

& ADOConnection::CachePageExecute	(	$	secs2cache,
		$	sql,
		$	nrows,
		$	page,
		$	inputarr = false
	)

Will select the supplied $page number from a recordset, given that it is paginated in pages of $nrows rows per page. It also saves two boolean values saying if the given page is the first and/or last one of the recordset. Added by Iván Oliva to provide recordset pagination.

Parameters:

	secs2cache	seconds to cache data, set to 0 to force query
	sql
	nrows	is the number of rows per page to get
	page	is the page number to get (1-based)
	[inputarr]	array of bind variables

Returns:

the recordset ($rs->databaseType == 'array')

Definition at line 2640 of file adodb.inc.php.

References PageExecute().

---

Member Data Documentation

ADOConnection::$_errorCode = false

then returned by the errorMsg() function

A variable which was used to keep the returned last error message. The value will

Definition at line 321 of file adodb.inc.php.

---

The documentation for this class was generated from the following file:

• typo3_src-4.1/typo3/sysext/adodb/adodb/adodb.inc.php

---