classBufferedRow

packages/ztd-query-pdo-adapter/src/Session/BufferedRow.php:22

final class BufferedRow

Restricted visibility: declared "@visibility ZtdQuery\Adapter\Pdo". Code outside that scope must not name this declaration.

Shapes a row ZTD buffered into what a fetch mode asks for.

A simulated statement never reaches the driver, so nothing shapes its rows the way PDO's own fetch modes would. The rows come back keyed by column; this turns one of them into the array, list or object the caller asked to fetch.

Methods§

public function inMode<TValue>(
    array<string, TValue> $row,
    int $mode,
): array<int|string, TValue>|TValue|stdClass|false

source §

Answers the row in the shape a fetch mode asks for.

A mode this does not know is read as PDO reads an unknown one: both ways at once, which is what PDO::FETCH_BOTH means.

Parameters

`$row`	`array<string, TValue>`	Row as ZTD buffered it, keyed by column
`$mode`	`int`	One of PDO::FETCH_*

Returns

array<int|string, TValue>|TValue|stdClass|false The row or column selected by the fetch mode

Test cases 7

Called from 2

Calls 7

class-const PDO::FETCH_ASSOC() line 39
class-const PDO::FETCH_NAMED() line 39
class-const PDO::FETCH_NUM() line 40
function-call array_values line 40
class-const PDO::FETCH_OBJ() line 41
class-const PDO::FETCH_COLUMN() line 42
method-call BufferedRow::keyedBothWays() line 43

public function keyedBothWays<TValue>(array<string, TValue> $row): array<int|string, TValue>

source §

Answers the row keyed by column name and by position at once.

Parameters

$row array<string, TValue> Row as ZTD buffered it, keyed by column

Returns

array<int|string, TValue> The same values, reachable under either key

Test cases 2

Called from 1

method-call ZtdQuery\Adapter\Pdo\Session\BufferedRow::inMode() packages/ztd-query-pdo-adapter/src/Session/BufferedRow.php:43

public function resolveMode(int $mode, int $connectionMode, ?int $statementMode): int

source §

Resolve FETCH_DEFAULT using statement options before connection options.

Parameters

`$mode`	`int`
`$connectionMode`	`int`
`$statementMode`	`?int`

Returns

int

Test cases 1

BufferedRowTest::testResolveModeUsesExplicitThenStatementThenConnectionMode calls

Called from 2

Calls 1

class-const PDO::FETCH_DEFAULT() line 72

public function fetch<TValue>(
    array<string, TValue>|false $row,
    int $mode,
): array<int|string, TValue>|TValue|stdClass|false

source §

Shape a buffered row while preserving the exhausted-cursor marker.

Parameters

`$row`	`array<string, TValue>\|false`
`$mode`	`int`

Returns

array<int|string, TValue>|TValue|stdClass|false

Test cases 1

BufferedRowTest::testFetchPreservesValues calls

Called from 1

method-call ZtdQuery\Adapter\Pdo\ZtdPdoStatement::fetch() packages/ztd-query-pdo-adapter/src/ZtdPdoStatement.php:190

Calls 1

method-call BufferedRow::inMode() line 84

public function all<TValue, TArgument>(
    array<int, array<string, TValue>> $rows,
    int $mode,
    array<TArgument> $arguments,
): list<array<int|string, TValue>|TValue|stdClass|false>

source §

Shape all remaining rows, including column selection arguments.

Parameters

`$rows`	`array<int, array<string, TValue>>`
`$mode`	`int`
`$arguments`	`array<TArgument>`

Returns

list<array<int|string, TValue>|TValue|stdClass|false>

Test cases 1

BufferedRowTest::testAllShapesRowsAndSelectsTheRequestedColumn calls

Called from 1

method-call ZtdQuery\Adapter\Pdo\ZtdPdoStatement::fetchAll() packages/ztd-query-pdo-adapter/src/ZtdPdoStatement.php:213

Calls 4

function-call is_int line 99
class-const PDO::FETCH_COLUMN() line 101
method-call BufferedRow::column() line 102
method-call BufferedRow::inMode() line 103

public function column<TValue>(array<string, TValue>|false $row, int $column): TValue|false

source §

Read one positional column while preserving the exhausted-cursor marker.

Parameters

`$row`	`array<string, TValue>\|false`
`$column`	`int`

Returns

TValue|false

Test cases 1

BufferedRowTest::testColumnPreservesNullAndMissingColumnBehavior calls

Called from 2

Calls 1

function-call array_values line 117

public function object<TValue, TObject of object, TArgument>(
    array<string, TValue>|false $row,
    class-string<TObject>|null $class,
    array<TArgument> $constructorArgs,
): ($class is null ? stdClass : TObject)|false