abstract class Query implements IteratorAggregate (View source)

Abstract query-result class. A query result provides an iterator that returns a map for each record of a query result.

The map should be keyed by the column names, and the values should use the following types:

  • boolean returned as integer 1 or 0 (to ensure consistency with MySQL that doesn't have native booleans)
  • integer types returned as integers
  • floating point / decimal types returned as floats
  • strings returned as strings
  • dates / datetimes returned as strings

Note that until SilverStripe 4.3, bugs meant that strings were used for every column type.

Once again, this should be subclassed by an actual database implementation. It will only ever be constructed by a subclass of SS_Database. The result of a database query - an iteratable object that's returned by DB::SS_Query

Primarily, the Query class takes care of the iterator plumbing, letting the subclasses focusing on providing the specific data-access methods that are required: {@link nextRecord()}, {@link numRecords()} and {@link seek()}

Methods

array
column(string $column = null)

Return an array containing all the values from a specific column. If no column is set, then the first will be returned

array
keyedColumn()

Return an array containing all values in the leftmost column, where the keys are the same as the values.

array
map()

Return a map from the first column to the second column.

array
record()

Returns the first record in the result

array
first() deprecated

No description

string
value()

Returns the first column of the first record.

string
table()

Return an HTML table containing the full result-set

array
getIterator()

Return the next record in the query result.

int
numRecords()

Return the total number of items in the query result.

Details

array column(string $column = null)

Return an array containing all the values from a specific column. If no column is set, then the first will be returned

Parameters

string $column

Return Value

array

array keyedColumn()

Return an array containing all values in the leftmost column, where the keys are the same as the values.

Return Value

array

array map()

Return a map from the first column to the second column.

Return Value

array

array record()

Returns the first record in the result

Return Value

array

array first() deprecated

deprecated Use record() instead

Return Value

array

string value()

Returns the first column of the first record.

Return Value

string

string table()

Return an HTML table containing the full result-set

Return Value

string

abstract array getIterator()

Return the next record in the query result.

Return Value

array

abstract int numRecords()

Return the total number of items in the query result.

Return Value

int