1:  2:  3:  4:  5:  6:  7:  8:  9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license  https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Models\Db\Readers;

class       Single 
extends     \MvcCore\Ext\Models\Db\Reader
implements  \MvcCore\Ext\Models\Db\Readers\ISingle {

    /**
     * @inheritDocs
     * @param string $fullClassName 
     * @param int $readingFlags 
     * @return \object
     */
    public function ToInstance ($fullClassName, $readingFlags = 0) {
        $this->fetchRawData(TRUE);
        if (!$this->rawData) return NULL;
        $type = new \ReflectionClass($fullClassName);
        if (!$type->hasMethod('SetValues'))
            throw new \InvalidArgumentException(
                "[".get_class()."] Class `{$fullClassName}` has no public method ".
                "`SetValues (\$data = [], \$propsFlags = 0): \MvcCore\Model`."
            );
        /** @var $result \MvcCore\Ext\Models\Db\Model */
        $result = $type->newInstanceWithoutConstructor();
        $result->SetValues($this->rawData, $readingFlags);
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @return array
     */
    public function ToArray () {
        $this->fetchRawData(TRUE);
        if (!$this->rawData) return NULL;
        $result = $this->rawData;
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @return \stdClass
     */
    public function ToObject () {
        $this->fetchRawData(TRUE);
        if (!$this->rawData) return NULL;
        $result = (object) $this->rawData;
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @param string $valueColumnName 
     * @param string $valueType 
     * @return bool|float|int|null|string
     */
    public function ToScalar ($valueColumnName, $valueType = NULL) {
        $this->fetchRawData(TRUE);
        if (
            !$this->rawData ||
            !array_key_exists($valueColumnName, $this->rawData)
        ) return NULL;
        $itemValue = $this->rawData[$valueColumnName];
        if ($valueType !== NULL)
            settype($itemValue, $valueType);
        $this->cleanUpData();
        return $itemValue;
    }

    /**
     * @inheritDocs
     * @param callable $valueCompleter 
     * @return mixed
     */
    public function ToAny (callable $valueCompleter) {
        $this->fetchRawData(TRUE);
        $result = $valueCompleter($this->rawData);
        $this->cleanUpData();
        return $result;
    }
}