<?php
/**
 * iCalcreator, a PHP rfc2445/rfc5545 solution.
 *
 * This file is a part of iCalcreator.
 *
 * Copyright (c) 2007-2017 Kjell-Inge Gustafsson, kigkonsult, All rights reserved
 * Link      http://kigkonsult.se/iCalcreator/index.php
 * Package   iCalcreator
 * Version   2.24
 * License   Subject matter of licence is the software iCalcreator.
 *           The above copyright, link, package and version notices,
 *           this licence notice and the [rfc5545] PRODID as implemented and
 *           invoked in iCalcreator shall be included in all copies or
 *           substantial portions of the iCalcreator.
 *           iCalcreator can be used either under the terms of
 *           a proprietary license, available at <https://kigkonsult.se/>
 *           or the GNU Affero General Public License, version 3:
 *           iCalcreator is free software: you can redistribute it and/or
 *           modify it under the terms of the GNU Affero General Public License
 *           as published by the Free Software Foundation, either version 3 of
 *           the License, or (at your option) any later version.
 *           iCalcreator 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 Affero General Public License for more details.
 *           You should have received a copy of the GNU Affero General Public
 *           License along with this program.
 *           If not, see <http://www.gnu.org/licenses/>.
 */
namespace kigkonsult\iCalcreator\traits;
use kigkonsult\iCalcreator\util\util;
/**
 * PERCENT-COMPLETE property functions
 *
 * @author Kjell-Inge Gustafsson, kigkonsult <ical@kigkonsult.se>
 * @since 2.22.23 - 2017-02-05
 */
trait PERCENT_COMPLETEtrait {
/**
 * @var array component property PERCENT_COMPLETE value
 * @access protected
 */
  protected $percentcomplete = null;
/**
 * Return formatted output for calendar component property percent-complete
 *
 * @return string
 */
  public function createPercentComplete() {
    if( ! isset( $this->percentcomplete ) ||
        ( empty( $this->percentcomplete ) && ! is_numeric( $this->percentcomplete )))
      return null;
    if(     ! isset( $this->percentcomplete[util::$LCvalue] ) ||
            ( empty( $this->percentcomplete[util::$LCvalue] ) &&
       ! is_numeric( $this->percentcomplete[util::$LCvalue] )))
      return ( $this->getConfig( util::$ALLOWEMPTY )) ? util::createElement( util::$PERCENT_COMPLETE ) : null;
    return util::createElement( util::$PERCENT_COMPLETE,
                                util::createParams( $this->percentcomplete[util::$LCparams] ),
                                $this->percentcomplete[util::$LCvalue] );
  }
/**
 * Set calendar component property percent-complete
 *
 * @param int    $value
 * @param array  $params
 * @return bool
 */
  public function setPercentComplete( $value, $params=null ) {
    if( empty( $value ) && ! is_numeric( $value )) {
      if( $this->getConfig( util::$ALLOWEMPTY ))
        $value = util::$EMPTYPROPERTY;
      else
        return false;
    }
    $this->percentcomplete = [util::$LCvalue  => $value,
                              util::$LCparams => util::setParams( $params )];
    return true;
  }
}