Selection: added fetchField()

Author: foxycode

src/Database/Table/Selection.php

@@ -223,6 +223,26 @@ public function fetch()
 	}
 
 
+	/**
+	 * Fetches single field.
+	 * @param  string|NULL
+	 * @return mixed|FALSE
+	 */
+	public function fetchField($column = NULL)
+	{
+		if ($column) {
+			$this->select($column);
+		}
+
+		$row = $this->fetch();
+		if ($row) {
+			return $column ? $row[$column] : array_values($row->toArray())[0];
+		}
+
+		return FALSE;
+	}
+
+
 	/**
 	 * @inheritDoc
 	 */

tests/Database/Table/Selection.fetchField().phpt

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * Test: Nette\Database\Table: Fetch field.
+ * @dataProvider? ../databases.ini
+ */
+
+use Tester\Assert;
+
+require __DIR__ . '/../connect.inc.php'; // create $connection
+
+Nette\Database\Helpers::loadFromFile($connection, __DIR__ . "/../files/{$driverName}-nette_test1.sql");
+
+
+test(function () use ($context) {
+	$title = $context->table('book')->where('id', 1)->fetchField('title');  // SELECT `title` FROM `book` WHERE `id` = 1
+	Assert::same('1001 tipu a triku pro PHP', $title);
+});
+
+
+test(function () use ($context) {
+	$title = $context->table('book')->where('id', 1)->select('title')->fetchField();  // SELECT `title` FROM `book` WHERE `id` = 1
+	Assert::same('1001 tipu a triku pro PHP', $title);
+});