<?php

/**
 * This file defines the txtfileresultset class
 *
 * @package CGExtensions
 * @category Query
 * @author  calguy1000 <calguy1000@cmsmadesimple.org>
 * @copyright Copyright 2010 by Robert Campbell
 */

namespace CGExtensions\query;

/**
 * A class to return lines out of a text file, suitable for using in some reports.
 * note: it may not be suitable to use a text file in a tabular report.
 *
 * @property string $fields Get the current record (in this case a line).
 * @see txtfilequery
 */
class txtfileresultset extends resultset
{
    /**
     * @ignore
     */
    private $_fileobj;

    /**
     * @ignore
     */
    protected function _query()
    {
        if( is_object($this->_fileobj) ) return;

        $this->_fileobj = new \SplFileObject($this->_filter['filename']);
        $this->_fileobj->seek($this->_filter['offset']);
    }

    /**
     * @ignore
     */
    public function __get($key)
    {
        if( $key == 'fields' ) {
            $rec = array();
            $rec['line'] = $this->_fileobj->key() + 1;
            $rec['text'] = $this->_fileobj->current();
            return $rec;
        }
        return parent::__get($key);
    }

    /**
     * Get the file object used in this query.
     *
     * @return \SplFileObject
     */
    protected function &get_fileobject()
    {
        return $this->_fileobj;
    }

    /**
     * Return the number of records that match this query.
     * in the case of this object, as no line counting is performed, this method always returns the limit property.
     */
    public function RecordCount()
    {
        $his->_query();
        return $this->_filter['limit'];
    }

    /**
     * Move to the next record (line) that matches the query.
     */
    public function MoveNext()
    {
        $this->_query();
        $line_num = $this->_fileobj->key();
        $this->_fileobj->seek($line_num+1);
    }

    /**
     * Move to the first record (line) that matches the query.
     */
    public function MoveFirst()
    {
        $this->_query();
        $this->_fileobj->seek($this->_filter['offset']);
    }

    /**
     * Test if we are at the end of our query matches.
     *
     * @return bool
     */
    public function EOF()
    {
        $this->_query();
        $line = $this->_fileobj->key();
        if( $this->_fileobj->eof() || $line >= $this->_filter['offset'] + $this->_filter['limit'] ) return TRUE;
        return FALSE;
    }

    /**
     * Close the file
     */
    public function Close() { }

    /**
     * Return the total number of records (lines) that match our query.
     * As the contents of the file are not scanned, this method always returns -1
     */
    public function TotalMatches()
    {
        return -1;
    }

    /**
     * Get the object representing this class
     *
     * @return \StdClass
     */
    public function &get_object()
    {
        $this->_query();
        $fields = $this->fields;
        $obj = new \Stdclass;
        foreach( $fields as $key => $val ) {
            $obj->$key = $val;
        }
        return $obj;
    }

} // end of class
?>
