class.ilXMLResultSet.php

Go to the documentation of this file.

<?php
  /*
   +-----------------------------------------------------------------------------+
   | ILIAS open source                                                           |
   +-----------------------------------------------------------------------------+
   | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
   |                                                                             |
   | This program is free software; you can redistribute it and/or               |
   | modify it under the terms of the GNU General Public License                 |
   | as published by the Free Software Foundation; either version 2              |
   | of the License, or (at your option) any later version.                      |
   |                                                                             |
   | This program is distributed in the hope that it will be useful,             |
   | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
   | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
   | GNU General Public License for more details.                                |
   |                                                                             |
   | You should have received a copy of the GNU General Public License           |
   | along with this program; if not, write to the Free Software                 |
   | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
   +-----------------------------------------------------------------------------+
  */


include_once './webservice/soap/classes/class.ilXMLResultSetColumn.php';
include_once './webservice/soap/classes/class.ilXMLResultSetRow.php';

class ilXMLResultSet
{
    private $colspecs = array();
    private $rows = array();
    
    public function getColumnName($index)
    {
        if (is_numeric($index) && ($index < 0 || $index > count($this->colspecs))) {
            return null;
        }
        return $this->colspecs[$index] instanceof ilXMLResultSetColumn ? $this->colspecs[$index]->getName() : null;
    }

    public function addColumn($columnname)
    {
        $this->colspecs [count($this->colspecs)] = new ilXMLResultSetColumn(count($this->colspecs), $columnname);
    }
                
    public function getIndexForColumn($columnname)
    {
        $idx = 0;
        foreach ($this->colspecs as $colspec) {
            if (strcasecmp($columnname, $colspec->getName()) == 0) {
                return $idx;
            }
            $idx++;
        }
        return -1;
    }
        
        
    public function hasColumn($columnname)
    {
        return $this->getIndexForColumn($columnname) != -1;
    }

    public function getColSpecs()
    {
        return $this->colspecs;
    }

    public function getRows()
    {
        return $this->rows;
    }

    public function addRow(&$row)
    {
        $this->rows [] = $row;
    }


    public function setArray($array)
    {
        $this->addArray($array, true);
    }

    public function addArray($array, $overwrite = false)
    {
        if ($overwrite) {
            $this->clear();
        }
        foreach ($array as $row) {
            if ($overwrite) {
                // add column names from first row
                $columnNames = array_keys($row);
                foreach ($columnNames as $columnName) {
                    $this->addColumn($columnName);
                }
                $overwrite = false;
            }
            $xmlRow = new ilXMLResultSetRow();
            $xmlRow->setValues($row);
            $this->addRow($xmlRow);
        }
    }

    public function clear()
    {
        $this->rows = array();
        $this->colspecs = array();
    }

    public function getColumnCount()
    {
        return count($this->colspecs);
    }

    public function getRowCount()
    {
        return count($this->rows);
    }
        
    public function getRow($idx)
    {
        if ($idx < 0 || $idx >= $this->getRowCount()) {
            throw new Exception("Index too small or too big!");
        }
        return $this->rows[$idx];
    }
        
    public function getValue($rowIdx, $colIdx)
    {
        $row = $this->getRow($rowIdx);
            
        if (!is_numeric($colIdx)) {
            $colIdx = $this->getIndexForColumn($colIdx);
        }
                
        return $row->getValue($colIdx);
    }
}