rkrx / php-mysql-query-builder

src/Builder/RunnableSelect.php

<?php

namespace Kir\MySQL\Builder;

use Generator;
use IteratorAggregate;
use Kir\MySQL\Builder\Helpers\DBIgnoreRow;
use Kir\MySQL\Tools\AliasReplacer;
use Traversable;

/**
 * @extends IteratorAggregate<int, array<string, mixed>>
 */
interface RunnableSelect extends Select, IteratorAggregate {
	/**
	 * @return AliasReplacer
	 */
	public function aliasReplacer(): AliasReplacer;

	/**
	 * @param array<string, mixed> $values
	 * @return $this
	 */
	public function bindValues(array $values);

	/**
	 * @param string $key
	 * @param string|int|bool|float|null $value
	 * @return $this
	 */
	public function bindValue(string $key, $value);

	/**
	 * @return $this
	 */
	public function clearValues(): self;

	/**
	 * @param bool $preserveTypes
	 * @return $this
	 */
	public function setPreserveTypes(bool $preserveTypes = true): self;

	/**
	 * Fetches all rows using PDO::FETCH_NUM
	 *
	 * @template T of mixed[]
	 * @param null|callable(array<string, null|scalar>): (void|DBIgnoreRow|T) $callback
	 * @return ($callback is null ? list<array<int, null|scalar>> : array<int, T>)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchIndexedRows($callback = null): array;

	/**
	 * @template T
	 * @param null|callable(array<string, null|scalar>): (void|DBIgnoreRow|T) $callback
	 * @return ($callback is null ? array<int, array<string, null|scalar>> : list<T>)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchRows($callback = null): array;

	/**
	 * @template T
	 * @param null|callable(array<string, null|scalar>): (void|DBIgnoreRow|T) $callback
	 * @return ($callback is null ? Generator<int, array<string, null|scalar>> : Generator<int, T>)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchRowsLazy($callback = null);

	/**
	 * @template T of array
	 * @param null|callable(array<string, mixed>): (T|void|DBIgnoreRow) $callback
	 * @return ($callback is null ? array<string, null|scalar> : T)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchRow($callback = null): array;

	/**
	 * @template T
	 * @template U
	 * @param class-string<T> $className

The doc comment class-string<T> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<T>.

	 * @param null|callable(T): U $callback
	 * @return ($callback is null ? array<int, T> : array<int, U>)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchObjects(string $className = 'stdClass', $callback = null): array;

	/**
	 * @template T
	 * @template U
	 * @param class-string<T> $className

The doc comment class-string<T> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<T>.

	 * @param null|callable(T): U $callback
	 * @return ($callback is null ? Generator<int, T> : Generator<int, U>)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchObjectsLazy($className = null, $callback = null);

	/**
	 * @template T
	 * @template U
	 * @param class-string<T> $className

The doc comment class-string<T> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<T>.

	 * @param null|callable(T): U $callback
	 * @return ($callback is null ? T : U)

The doc comment ($callback at position 1 could not be parsed: Unknown type name '$callback' at position 1 in ($callback.

	 */
	public function fetchObject($className = null, $callback = null);

	/**
	 * @param bool $treatValueAsArray
	 * @return array<array-key, mixed>

The doc comment array<array-key, mixed> at position 2 could not be parsed: Unknown type name 'array-key' at position 2 in array<array-key, mixed>.

	 */
	public function fetchKeyValue($treatValueAsArray = false): array;

	/**
	 * @param string[] $fields
	 * @return array<string, array<int, mixed>>
	 */
	public function fetchGroups(array $fields): array;

	/**
	 * @template T
	 * @param null|callable(null|scalar): T $fn
	 * @return ($fn is null ? array<int, null|scalar> : array<int, T>)

The doc comment ($fn at position 1 could not be parsed: Unknown type name '$fn' at position 1 in ($fn.

	 */
	public function fetchArray(?callable $fn = null): array;

	/**
	 * @template TDefault
	 * @template TCastFn
	 * @param TDefault $default

The type Kir\MySQL\Builder\TDefault was not found. Maybe you did not declare it correctly or list all dependencies?

	 * @param null|callable(null|bool|string|int|float): TCastFn $fn
	 * @return ($fn is null ? null|scalar|TDefault : TCastFn)

The doc comment ($fn at position 1 could not be parsed: Unknown type name '$fn' at position 1 in ($fn.

	 */
	public function fetchValue($default = null, ?callable $fn = null);

	/**
	 * @return int
	 */
	public function getFoundRows(): int;

	/**
	 * @return Traversable<int, array<string, mixed>>
	 */
	public function getIterator(): Traversable;
}