Smr\DatabaseResult

Complexity

Total Complexity

8

Size/Duplication

Total Lines	36
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	getNumRecords()	0	6	2
A	__construct()	0	3	1
A	records()	0	3	2
A	hasRecord()	0	2	1
A	record()	0	5	2

<?php declare(strict_types=1);

namespace Smr;

use Exception;
use Generator;
use mysqli_result;
use RuntimeException;

/**
 * Holds the result of a Database query (e.g. read or write).
 */
class DatabaseResult {

	public function __construct(
		private readonly mysqli_result $dbResult
	) {}

	/**
	 * Use to iterate over the records from the result set.
	 * @return \Generator<DatabaseRecord>
	 */
	public function records(): Generator {
		foreach ($this->dbResult as $dbRecord) {
			yield new DatabaseRecord($dbRecord);
		}
	}

	/**
	 * Use when exactly one record is expected from the result set.
	 */
	public function record(): DatabaseRecord {
		if ($this->getNumRecords() != 1) {
			throw new RuntimeException('One record required, but found ' . $this->getNumRecords());
		}
		return new DatabaseRecord($this->dbResult->fetch_assoc());
	}

	public function getNumRecords(): int {
		$numRows = $this->dbResult->num_rows;
		if (is_string($numRows)) {

The condition is_string($numRows) is always false.

			throw new Exception('Number of rows is too large to represent as an int: ' . $numRows);
		}
		return $numRows;
	}

	public function hasRecord(): bool {
		return $this->getNumRecords() > 0;
	}

}