class.ilXMLResultSet.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilXMLResultSet
{
    private array $colspecs = [];
    private array $rows = [];

    public function getColumnName(int $index): ?string
    {
        if ($index < 0 || $index > count($this->colspecs)) {
            return null;
        }
        return $this->colspecs[$index] instanceof ilXMLResultSetColumn ? $this->colspecs[$index]->getName() : null;
    }

    public function addColumn(string $columnname): void
    {
        $this->colspecs[] = new ilXMLResultSetColumn(count($this->colspecs), $columnname);
    }

    public function getIndexForColumn(string $columnname): int
    {
        $idx = 0;
        foreach ($this->colspecs as $colspec) {
            if (strcasecmp($columnname, $colspec->getName()) === 0) {
                return $idx;
            }
            $idx++;
        }
        return -1;
    }

    public function hasColumn(string $columnname): bool
    {
        return $this->getIndexForColumn($columnname) !== -1;
    }

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

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

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

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

    public function addArray(array $array, bool $overwrite = false): void
    {
        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(): void
    {
        $this->rows = array();
        $this->colspecs = array();
    }

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

    public function getRowCount(): int
    {
        return count($this->rows);
    }

    public function getRow($idx): ilXMLResultSetRow
    {
        if ($idx < 0 || $idx >= $this->getRowCount()) {
            throw new DomainException("Index too small or too big: " . $idx);
        }
        return $this->rows[$idx];
    }

    public function getValue(int $rowIdx, $colIdx): string
    {
        $row = $this->getRow($rowIdx);

        if (!is_numeric($colIdx)) {
            $colIdx = $this->getIndexForColumn($colIdx);
        }
        return $row->getValue($colIdx);
    }
}