diff --git a/reference/pdo/functions/PDOStatement-bindColumn.xml b/reference/pdo/functions/PDOStatement-bindColumn.xml index 9d09a1505c..0fe842fd69 100644 --- a/reference/pdo/functions/PDOStatement-bindColumn.xml +++ b/reference/pdo/functions/PDOStatement-bindColumn.xml @@ -1,5 +1,5 @@ - + @@ -143,7 +143,7 @@ strawberry red 25 PDOStatement::execute PDOStatement::fetch PDOStatement::fetchAll - PDOStatement::fetchSingle + PDOStatement::fetchColumn diff --git a/reference/pdo/functions/PDOStatement-fetch.xml b/reference/pdo/functions/PDOStatement-fetch.xml index 0202e7aa4c..93c9e905e6 100644 --- a/reference/pdo/functions/PDOStatement-fetch.xml +++ b/reference/pdo/functions/PDOStatement-fetch.xml @@ -1,5 +1,5 @@ - + @@ -237,7 +237,7 @@ Reading backwards: PDO::query PDOStatement::fetchAll - PDOStatement::fetchSingle + PDOStatement::fetchColumn PDOStatement::prepare PDOStatement::setFetchMode diff --git a/reference/pdo/functions/PDOStatement-fetchAll.xml b/reference/pdo/functions/PDOStatement-fetchAll.xml index e5dbd8abc2..77d07c55fa 100644 --- a/reference/pdo/functions/PDOStatement-fetchAll.xml +++ b/reference/pdo/functions/PDOStatement-fetchAll.xml @@ -1,5 +1,5 @@ - + @@ -106,7 +106,7 @@ Array PDO::query PDOStatement::fetch - PDOStatement::fetchSingle + PDOStatement::fetchColumn PDOStatement::prepare PDOStatement::setFetchMode diff --git a/reference/pdo/functions/PDOStatement-fetchColumn.xml b/reference/pdo/functions/PDOStatement-fetchColumn.xml new file mode 100644 index 0000000000..089588f5e8 --- /dev/null +++ b/reference/pdo/functions/PDOStatement-fetchColumn.xml @@ -0,0 +1,123 @@ + + + + + + PDOStatement::fetchColumn + + Returns a single column from the next row of a result set + + + + + &reftitle.description; + + stringPDOStatement::fetchColumn + intcolumn_number + + + &warn.experimental.func; + + + Returns a single column from the next row of a result set. + + + + + &reftitle.parameters; + + + + column_number + + + Number of the column you wish to retrieve from the row. If no value is + supplied, PDOStatement::fetchColumn fetches the + first column. + + + + + + + + + &reftitle.returnvalues; + + PDOStatement::fetchColumn returns a single column + in the next row of a result set. + + + + There is no way to return a second column from the same row if you + use PDOStatement::fetchColumn to retrieve data. + + + + + + &reftitle.examples; + + Return first column of the next row + +prepare("SELECT name, colour FROM fruit"); +$sth->execute(); + +/* Fetch the first column from the next row in the result set */ +print("Fetch the first column from the next row in the result set:\n"); +$result = $sth->fetchColumn(); +print("$result\n"); + +$result = $sth->fetchColumn(); +print("$result\n"); +?> +]]> + + &example.outputs; + + + + + + + + + &reftitle.seealso; + + + PDO::query + PDOStatement::fetch + PDOStatement::fetchAll + PDOStatement::prepare + PDOStatement::setFetchMode + + + + + + diff --git a/reference/pdo/functions/PDOStatement-fetchSingle.xml b/reference/pdo/functions/PDOStatement-fetchSingle.xml deleted file mode 100644 index 0ea0bd7f2e..0000000000 --- a/reference/pdo/functions/PDOStatement-fetchSingle.xml +++ /dev/null @@ -1,102 +0,0 @@ - - - - - - PDOStatement::fetchSingle - - Returns the first column in the next row of a result set - - - - - &reftitle.description; - - stringPDOStatement::fetchSingle - - - - &warn.experimental.func; - - - - &reftitle.returnvalues; - - PDOStatement::fetchSingle returns the first column - in the next row of a result set as a string value. - - - - There is no way to return the second or subsequent columns from a row - if you use this method to retrieve data. - - - - - - - &reftitle.examples; - - Return first column of the next row - -prepare("SELECT name, colour FROM fruit"); -$sth->execute(); - -/* Fetch the first column from the next row in the result set */ -print("Fetch the first column from the next row in the result set:\n"); -$result = $sth->fetchSingle(); -print("$result\n"); - -$result = $sth->fetchSingle(); -print("$result\n"); -?> -]]> - - &example.outputs; - - - - - - - - - &reftitle.seealso; - - - PDO::query - PDOStatement::fetch - PDOStatement::fetchAll - PDOStatement::prepare - PDOStatement::setFetchMode - - - - - - diff --git a/reference/pdo/functions/PDOStatement-rowCount.xml b/reference/pdo/functions/PDOStatement-rowCount.xml index 364a52cfb1..c2b6588a09 100644 --- a/reference/pdo/functions/PDOStatement-rowCount.xml +++ b/reference/pdo/functions/PDOStatement-rowCount.xml @@ -1,5 +1,5 @@ - + @@ -66,7 +66,7 @@ Deleted 9 rows. return the number of rows affected by a SELECT statement. Instead, use PDO::query to issue a SELECT COUNT(*) statement with the same predicates as your intended SELECT statement, then use - PDOStatement::fetchSingle to retrieve the number + PDOStatement::fetchColumn to retrieve the number of rows that will be returned. Your application can then perform the correct action. @@ -77,7 +77,7 @@ $sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100"; if ($res = $conn->query($sql)) { // Check the number of rows that match the SELECT statement - if ($res->fetchSingle() > 0) { + if ($res->fetchColumn() > 0) { // Issue the real SELECT statement and work with the results $sql = "SELECT name FROM fruit WHERE calories > 100"; @@ -114,8 +114,8 @@ pear PDOStatement::columnCount + PDOStatement::fetchColumn PDOStatement::query - PDOStatement::fetchSingle