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 array, and 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 129 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 143 of file class.SurveyCategories.php.

         {
                 $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 array.

         {
                 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 314 of file class.SurveyCategories.php.

References array.

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

◆ getCategories()

SurveyCategories::getCategories ( )

Get categories.

Parameters

Definition at line 325 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 212 of file class.SurveyCategories.php.

         {
                 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 230 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 246 of file class.SurveyCategories.php.

         {
                 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 265 of file class.SurveyCategories.php.

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

◆ getNewScale()

SurveyCategories::getNewScale ( )

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

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 290 of file class.SurveyCategories.php.

References 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 110 of file class.SurveyCategories.php.

         {
                 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 100 of file class.SurveyCategories.php.

         {
                 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 172 of file class.SurveyCategories.php.

         {
                 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 157 of file class.SurveyCategories.php.

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 190 of file class.SurveyCategories.php.

References 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 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

Public Member Functions

Data Fields

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addCategory()

◆ addCategoryArray()

◆ addCategoryAtPosition()

◆ flushCategories()

◆ getCategories()

◆ getCategory()

◆ getCategoryCount()

◆ getCategoryForScale()

◆ getCategoryIndex()

◆ getIndex()

◆ getNewScale()

◆ getScale()

◆ moveCategoryDown()

◆ moveCategoryUp()

◆ removeCategories()

◆ removeCategory()

◆ removeCategoryWithName()

Field Documentation

◆ $categories

◆ $log