Configuration/src/structs/ini_item.php

<?php
/**
 * File containing the ezcConfigurationIniItem class
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 * 
 *   http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
 * @version //autogentag//
 * @filesource
 * @package Configuration
 */

/**
 * A container to store one INI settings item
 *
 * This struct is used in various classes to store the data accompanying one
 * INI setting.
 *
 * @package Configuration
 * @version //autogentag//
 */
class ezcConfigurationIniItem extends ezcBaseStruct
{
    /**
     * The Configuration item is a setting.
     *
     * @var int
     */
    const SETTING = 1;

    /**
     * The Configuration item is a group..
     *
     * @var int
     */
    const GROUP_HEADER = 2;

    /**
     * The item type.
     *
     * Either SETTING or GROUP_HEADER.
     *
     * @var int
     */
    public $type;

    /**
     * The name of the group this setting belongs to.
     *
     * @var string
     */
    public $group;

    /**
     * The name of the setting or the group.
     *
     * @var string
     */
    public $setting;

    /**
     * The dimensions of the setting.
     *
     * @var string
     */
    public $dimensions;

    /**
     * Comments that belong to this setting.
     *
     * @var string
     */
    public $comments;

    /**
     * The setting's value.
     *
     * @var mixed
     */
    public $value;

    /**
     * Constructs an ezcConfigurationIniItem object.
     *
     * @param int $type Either SETTING or GROUP_HEADER
     * @param string $group
     * @param string $setting
     * @param string $dimensions
     * @param string $comments
     * @param mixed $value
     */
    function __construct( $type, $group, $setting, $dimensions, $comments, $value )
    {
        $this->type = $type;
        $this->group = $group;
        $this->setting = $setting;
        $this->dimensions = $dimensions;
        $this->comments = $comments;
        $this->value = $value;
    }

    /**
     * Returns a new instance of this class with the data specified by $array.
     *
     * $array contains all the data members of this class in the form:
     * array('member_name'=>value).
     *
     * __set_state makes this class exportable with var_export.
     * var_export() generates code, that calls this method when it
     * is parsed with PHP.
     *
     * @param array(string=>mixed) $array
     * @return ezcConfigurationIniItem
     * @ignore
     */
    static public function __set_state( array $array )
    {
        return new ezcConfigurationIniItem(
            $array['type'], $array['group'], $array['setting'],
            $array['dimensions'], $array['comments'], $array['value']
        );
    }
}
?>