Class: MDB2_Driver_mssql

Source Location: /MDB2-2.0.0beta3/MDB2/Driver/mssql.php

Class Overview

PEAR
   |
   --MDB2_Driver_Common
      |
      --MDB2_Driver_mssql

MDB2 MSSQL Server driver

Author(s):

Frank M. Kromann <mailto:frank at kromann.info>

Inherited Variables

Class: MDB2_Driver_Common

MDB2_Driver_Common::$db_index
MDB2_Driver_Common::$debug_output
MDB2_Driver_Common::$last_query
MDB2_Driver_Common::$options
MDB2_Driver_Common::$supported

Inherited Methods

Class: MDB2_Driver_Common

MDB2_Driver_Common::MDB2_Driver_Common(): PHP 4 Constructor
MDB2_Driver_Common::beginTransaction(): Start a transaction.
MDB2_Driver_Common::commit(): Commit the database changes done during a transaction that is in progress. This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after committing the pending changes.
MDB2_Driver_Common::currID(): returns the current id of a sequence
MDB2_Driver_Common::debug(): set a debug message
MDB2_Driver_Common::debugOutput(): output debug info
MDB2_Driver_Common::disconnect(): Log out and disconnect from the database.
MDB2_Driver_Common::errorInfo(): This method is used to collect information about an error
MDB2_Driver_Common::errorNative(): returns an errormessage, provides by the database
MDB2_Driver_Common::escape(): Quotes a string so it can be safely used in a query. It will quote the text so it can safely be used within a query.
MDB2_Driver_Common::getAfterID(): returns the autoincrement ID if supported or $id
MDB2_Driver_Common::getBeforeID(): returns the next free id of a sequence if the RDBMS does not support auto increment
MDB2_Driver_Common::getDatabase(): get the current database
MDB2_Driver_Common::getDeclaration(): Obtain DBMS specific SQL code portion needed to declare of the given type
MDB2_Driver_Common::getDSN(): return the DSN as a string
MDB2_Driver_Common::getOption(): returns the value of an option
MDB2_Driver_Common::getSequenceName(): adds sequence name formating to a sequence name
MDB2_Driver_Common::getWarnings(): get all warnings in reverse order.
MDB2_Driver_Common::loadModule(): loads a module
MDB2_Driver_Common::nextID(): returns the next free id of a sequence
MDB2_Driver_Common::prepare(): Prepares a query for multiple execution with execute().
MDB2_Driver_Common::query(): Send a query to the database and return any results
MDB2_Driver_Common::queryAll(): Execute the specified query, fetch all the rows of the result set into a two dimensional array and then frees the result set.
MDB2_Driver_Common::queryCol(): Execute the specified query, fetch the value from the first column of each row of the result set into an array and then frees the result set.
MDB2_Driver_Common::queryOne(): Execute the specified query, fetch the value from the first column of the first row of the result set and then frees the result set.
MDB2_Driver_Common::queryRow(): Execute the specified query, fetch the values from the first row of the result set into an array and then frees the result set.
MDB2_Driver_Common::quote(): Convert a text value into a DBMS specific format that is suitable to compose query statements.
MDB2_Driver_Common::quoteIdentifier(): Quote a string so it can be safely used as a table or column name
MDB2_Driver_Common::raiseError(): This method is used to communicate an error and invoke error callbacks etc. Basically a wrapper for PEAR::raiseError without the message string.
MDB2_Driver_Common::replace(): Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT query, except that if there is already a row in the table with the same key field values, the REPLACE query just updates its values instead of inserting a new row.
MDB2_Driver_Common::resetWarnings(): reset the warning array
MDB2_Driver_Common::rollback(): Cancel any database changes done during a transaction that is in progress. This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after canceling the pending changes.
MDB2_Driver_Common::setDatabase(): Select a different database
MDB2_Driver_Common::setDSN(): set the DSN
MDB2_Driver_Common::setFetchMode(): Sets which fetch mode should be used by default on queries on this connection
MDB2_Driver_Common::setLimit(): set the range of the next query
MDB2_Driver_Common::setOption(): set the option for the db class
MDB2_Driver_Common::standaloneQuery(): execute a query as database administrator
MDB2_Driver_Common::subSelect(): simple subselect emulation: leaves the query untouched for all RDBMS that support subselects
MDB2_Driver_Common::supports(): Tell whether a DB implementation or its backend extension supports a given feature.
MDB2_Driver_Common::__toString(): String conversation

Class Details

[line 56]
MDB2 MSSQL Server driver

Author: Frank M. Kromann <mailto:frank@kromann.info>

[ Top ]

Class Variables

$escape_quotes = "'"

[line 59]

Type:

mixed

[ Top ]

Method Detail

beginTransaction [line 173]

mixed beginTransaction(
)

Start a transaction.

Return: MDB2_OK on success, a MDB2 error on failure
Access: public

Overrides MDB2_Driver_Common::beginTransaction() (Start a transaction.)

[ Top ]

commit [line 201]

mixed commit(
)

Commit the database changes done during a transaction that is in progress.

Return: MDB2_OK on success, a MDB2 error on failure
Access: public

Overrides MDB2_Driver_Common::commit() (Commit the database changes done during a transaction that is in progress. This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after committing the pending changes.)

[ Top ]

connect [line 249]

true connect(
)

Connect to the database

Return: on success, MDB2 Error Object on failure

[ Top ]

disconnect [line 306]

mixed disconnect(
[mixed
$force = true])

Log out and disconnect from the database.

Return: true on success, false if not connected and error object on error
Access: public

Overrides MDB2_Driver_Common::disconnect() (Log out and disconnect from the database.)

[ Top ]

errorInfo [line 101]

array errorInfo(
[integer
$error = null])

This method is used to collect information about an error

Access: public

Overrides MDB2_Driver_Common::errorInfo() (This method is used to collect information about an error)

Parameters:

integer $error —

[ Top ]

getAfterID [line 453]

mixed getAfterID(
mixed
$id, string
$table)

returns the autoincrement ID if supported or $id

Return: MDB2 Error Object or id
Access: public

Overrides MDB2_Driver_Common::getAfterID() (returns the autoincrement ID if supported or $id)

Parameters:

mixed	`$id`	—	value as returned by getBeforeId()
string	`$table`	—	name of the table into which a new row was inserted

[ Top ]

nextID [line 407]

mixed nextID(
string
$seq_name, [boolean
$ondemand = true])

returns the next free id of a sequence

Return: MDB2 Error Object or id
Access: public

Overrides MDB2_Driver_Common::nextID() (returns the next free id of a sequence)

Parameters:

string	`$seq_name`	—	name of the sequence
boolean	`$ondemand`	—	when true the seqence is automatic created, if it not exists

[ Top ]

quoteIdentifier [line 159]

string quoteIdentifier(
string
$str)

Quote a string so it can be safely used as a table / column name

Quoting style depends on which database driver is being used.

Return: quoted identifier string
Access: public
Since: 1.6.0

Overrides MDB2_Driver_Common::quoteIdentifier() (Quote a string so it can be safely used as a table or column name)

Parameters:

string $str — identifier name to be quoted

[ Top ]

rollback [line 226]

mixed rollback(
)

Cancel any database changes done during a transaction that is in progress.

Return: MDB2_OK on success, a MDB2 error on failure
Access: public

Overrides MDB2_Driver_Common::rollback() (Cancel any database changes done during a transaction that is in progress. This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after canceling the pending changes.)

[ Top ]