SurveyCategories Class Reference

Class SurveyCategories. More...

Collaboration diagram for SurveyCategories:

Public Member Functions
	__construct ()
	Constructor public. More...
	getCategoryCount ()
	Returns the number of categories. More...
	addCategoryAtPosition ($categoryname, $position, $other=0, $neutral=0, $label=null)
	Adds a category at a given position. More...
	moveCategoryUp ($index)
	moveCategoryDown ($index)
	addCategory ($categoryname, $other=0, $neutral=0, $label=null, $scale=null)
	Adds a category. More...
	addCategoryArray ($categories)
	Adds a category array. More...
	removeCategory ($index)
	Removes a category from the list of categories. More...
	removeCategories ($array)
	Removes many categories from the list of categories. More...
	removeCategoryWithName ($name)
	Removes a category from the list of categories. More...
	getCategory ($index)
	Returns the name of a category for a given index. More...
	getCategoryForScale ($scale)
	Returns the name of a category for a given index. More...
	getCategoryIndex ($name)
	Returns the index of a category with a given name. More...
	getIndex ($category)
	Returns the index of a category. More...
	getNewScale ()
	getScale ($index)
	flushCategories ()
	Empties the categories list. More...
	getCategories ()
	Get categories. More...

Data Fields
	$categories

Protected Attributes
	$log

Detailed Description

Class SurveyCategories.

Author

Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Version

$Id$

Definition at line 34 of file class.SurveyCategories.php.

Constructor & Destructor Documentation

__construct()

SurveyCategories::__construct

(

)

Constructor public.

Definition at line 56 of file class.SurveyCategories.php.

References ilLoggerFactory\getLogger().

    {
        $this->categories = array();
        $this->log = ilLoggerFactory::getLogger("svy");
    }

Here is the call graph for this function:

Member Function Documentation

addCategory()

SurveyCategories::addCategory	(		$categoryname,
			$other = 0,
			$neutral = 0,
			$label = null,
			$scale = null
	)

Adds a category.

Adds a category

Parameters

integer

$categoryname

The name of the category public

See also

$categories

Definition at line 124 of file class.SurveyCategories.php.

    {
        array_push($this->categories, new ilSurveyCategory($categoryname, $other, $neutral, $label, $scale));
    }

addCategoryArray()

SurveyCategories::addCategoryArray

(

$categories

)

Adds a category array.

Adds a category array

Parameters

array

$categories

An array with categories public

See also

$categories

Definition at line 138 of file class.SurveyCategories.php.

References $categories.

    {
        $this->categories = array_merge($this->categories, $categories);
    }

addCategoryAtPosition()

SurveyCategories::addCategoryAtPosition	(		$categoryname,
			$position,
			$other = 0,
			$neutral = 0,
			$label = null
	)

Adds a category at a given position.

Adds a category at a given position

Parameters

string	$categoryname	The name of the category
integer	$position	The position of the category (starting with index 0) public

See also

$categories

Definition at line 86 of file class.SurveyCategories.php.

References $tail.

    {
        if (array_key_exists($position, $this->categories)) {
            $head = array_slice($this->categories, 0, $position);
            $tail = array_slice($this->categories, $position);
            $this->categories = array_merge($head, array(new ilSurveyCategory($categoryname, $other, $neutral, $label)), $tail);
        } else {
            array_push($this->categories, new ilSurveyCategory($categoryname, $other, $neutral, $label));
        }
    }

flushCategories()

SurveyCategories::flushCategories

(

)

Empties the categories list.

Empties the categories list

public

See also

$categories

Definition at line 297 of file class.SurveyCategories.php.

    {
        $this->categories = array();
    }

getCategories()

SurveyCategories::getCategories

(

)

Get categories.

Parameters

Definition at line 308 of file class.SurveyCategories.php.

References $categories.

    {
        return $this->categories;
    }

getCategory()

SurveyCategories::getCategory

(

$index

)

Returns the name of a category for a given index.

Returns the name of a category for a given index

Parameters

integer

$index

The index of the category

Returns

string Category name public

See also

$categories

Definition at line 204 of file class.SurveyCategories.php.

References $index.

    {
        if (array_key_exists($index, $this->categories)) {
            return $this->categories[$index];
        } else {
            return "";
        }
    }

getCategoryCount()

SurveyCategories::getCategoryCount

(

)

Returns the number of categories.

Returns the number of categories

Returns

integer The number of contained categories public

See also

$categories

Definition at line 71 of file class.SurveyCategories.php.

    {
        return count($this->categories);
    }

getCategoryForScale()

SurveyCategories::getCategoryForScale

(

$scale

)

Returns the name of a category for a given index.

Parameters

integer

$scale

The scale of the category

Returns

string Category object

Definition at line 219 of file class.SurveyCategories.php.

    {
        foreach ($this->categories as $cat) {
            if ($cat->scale == $scale) {
                return $cat;
            }
        }
        return null;
    }

getCategoryIndex()

SurveyCategories::getCategoryIndex

(

$name

)

Returns the index of a category with a given name.

Parameters

string

$name

The name of the category public

See also

$categories

Definition at line 236 of file class.SurveyCategories.php.

References $index, and $name.

    {
        foreach ($this->categories as $index => $category) {
            if (strcmp($category->title, $name) == 0) {
                return $index;
            }
        }
        return null;
    }

getIndex()

SurveyCategories::getIndex

(

$category

)

Returns the index of a category.

Parameters

string

$category

The category object public

See also

$categories

Definition at line 253 of file class.SurveyCategories.php.

References $index.

    {
        foreach ($this->categories as $index => $cat) {
            if ($cat == $category) {
                return $index;
            }
        }
        return null;
    }

getNewScale()

SurveyCategories::getNewScale

(

)

Definition at line 263 of file class.SurveyCategories.php.

References $index.

Referenced by getScale().

    {
        $max = 0;
        foreach ($this->categories as $index => $category) {
            if (is_object($category) && $category->scale > 0) {
                if ($category->scale > $max) {
                    $max = $category->scale;
                }
            }
        }
        return $max + 1;
    }

Here is the caller graph for this function:

getScale()

SurveyCategories::getScale

(

$index

)

Definition at line 276 of file class.SurveyCategories.php.

References $index, and getNewScale().

    {
        $obj = $this->categories[$index];
        if (is_object($obj) && $obj->scale > 0) {
            $this->log->debug("getScale has scale =" . $obj->scale);
            return $obj->scale;
        } else {
            $obj->scale = $this->getNewScale();
            $this->log->debug("getScale needed new scale, scale =" . $obj->scale);
            return $obj->scale;
        }
    }

Here is the call graph for this function:

moveCategoryDown()

SurveyCategories::moveCategoryDown

(

$index

)

Definition at line 106 of file class.SurveyCategories.php.

References $index.

    {
        if ($index < (count($this->categories) - 1)) {
            $temp = $this->categories[$index + 1];
            $this->categories[$index + 1] = $this->categories[$index];
            $this->categories[$index] = $temp;
        }
    }

moveCategoryUp()

SurveyCategories::moveCategoryUp

(

$index

)

Definition at line 97 of file class.SurveyCategories.php.

References $index.

    {
        if ($index > 0) {
            $temp = $this->categories[$index - 1];
            $this->categories[$index - 1] = $this->categories[$index];
            $this->categories[$index] = $temp;
        }
    }

removeCategories()

SurveyCategories::removeCategories

(

$array

)

Removes many categories from the list of categories.

Removes many categories from the list of categories

Parameters

array

$array

An array containing the index positions of the categories to be removed public

See also

$categories

Definition at line 167 of file class.SurveyCategories.php.

References $index.

    {
        foreach ($array as $index) {
            unset($this->categories[$index]);
        }
        $this->categories = array_values($this->categories);
    }

removeCategory()

SurveyCategories::removeCategory

(

$index

)

Removes a category from the list of categories.

Removes a category from the list of categories

Parameters

integer

$index

The index of the category to be removed public

See also

$categories

Definition at line 152 of file class.SurveyCategories.php.

References $index.

Referenced by removeCategoryWithName().

    {
        unset($this->categories[$index]);
        $this->categories = array_values($this->categories);
    }

Here is the caller graph for this function:

removeCategoryWithName()

SurveyCategories::removeCategoryWithName

(

$name

)

Removes a category from the list of categories.

Removes a category from the list of categories

Parameters

string

$name

The name of the category to be removed public

See also

$categories

Definition at line 184 of file class.SurveyCategories.php.

References $index, $name, and removeCategory().

    {
        foreach ($this->categories as $index => $category) {
            if (strcmp($category->title, $name) == 0) {
                $this->removeCategory($index);
                return;
            }
        }
    }

Here is the call graph for this function:

Field Documentation

$categories

SurveyCategories::$categories

Definition at line 50 of file class.SurveyCategories.php.

Referenced by addCategoryArray(), and getCategories().

$log

SurveyCategories::$log

protected

Definition at line 40 of file class.SurveyCategories.php.

---

The documentation for this class was generated from the following file:

• Modules/SurveyQuestionPool/classes/class.SurveyCategories.php