+Show TOC
×Hide TOC

Percent

Kind of class:	class
Inherits from:	CoreObject
Version:	12/01/06
Author:	Aaron Clinger
Classpath:	org.casaframework.math.Percent
File last modified:	Sunday, 19 August 2007, 13:43:31

► View source

▼ Hide source

/*
    CASA Framework for ActionScript 2.0
    Copyright (C) 2007  CASA Framework
    http://casaframework.org
    
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.
    
    This library 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
    Lesser General Public License for more details.
    
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
*/

import org.casaframework.core.CoreObject;

/**
    Creates a standardized way of describing and storing percentages. You can store and receive percentages in two different formats; regular percentage or as an decimal percentage.
    
    If percent is 37.5% a regular percentage would be expressed as <code>37.5</code> while the decimal percentage will be expressed <code>.375</code>.
    
    @author Aaron Clinger
    @version 12/01/06
    @example
        <code>
            var boxWidthPer:Percent = new Percent();
            this.boxWidthPer.setPercentage(25);
            
            this.box_mc._width *= boxWidthPer.getDecimalPercentage();
        </code>
*/

class org.casaframework.math.Percent extends CoreObject {
    private var $percent:Number;
    
    /**
        Creates a new percentage class with the option of defining the percent on creation.
        
        @param percentage: <strong>[optional]</strong> Percent formated at a percentage or an decimal percentage.
        @param isDecimalPercentage: <strong>[optional]</strong> Indicates if the parameter <code>percentage</code> is a decimal percentage <code>true</code>, or regular percentage <code>false</code>; defaults to <code>true</code>.
    */
    public function Percent(percentage:Number, isDecimalPercentage:Boolean) {
        super();
        
        if (isDecimalPercentage == true || isDecimalPercentage == undefined)
            this.setDecimalPercentage(percentage);
        else
            this.setPercentage(percentage);
        
        this.$setClassDescription('org.casaframework.math.Percent');
    }
    
    /**
        Sets the percentage.
        
        @param percent: Percent expressed as a regular percentage. 37.5% would be expressed as <code>37.5</code>.
    */
    public function setPercentage(percent:Number):Void {
        this.$percent = percent * .01;
    }
    
    /**
        Gets the percentage.
        
        @return Returns percent expressed as a regular percentage. 37.5% would be returned as <code>37.5</code>.
    */
    public function getPercentage():Number {
        return 100 * this.$percent;
    }
    
    /**
        Sets the percentage.
        
        @param percent: Percent expressed as a decimal percentage. 37.5% would be expressed as <code>.375</code>.
    */
    public function setDecimalPercentage(percent:Number):Void {
        this.$percent = percent;
    }
    
    /**
        Gets the percentage.
        
        @return Returns percent expressed as a decimal percentage. 37.5% would be returned as <code>.375</code>.
    */
    public function getDecimalPercentage():Number {
        return this.$percent;
    }
    
    /**
        Determines whether the percent specified in the <code>percent</code> parameter is equal to this percent object.

        @param percent: A defined {@link Percent} object.
        @return Returns <code>true</code> if percents are identical; otherwise <code>false</code>.
    */
    public function equals(percent:Percent):Boolean {
        return this.getDecimalPercentage() == percent.getDecimalPercentage();
    }
    
    /**
        @return A new percent object with the same value as this percent.
    */
    public function clone():Percent {
        return new Percent(this.getDecimalPercentage());
    }
    
    public function destroy():Void {
        delete this.$percent;
        super.destroy();
    }
}

Creates a standardized way of describing and storing percentages. You can store and receive percentages in two different formats; regular percentage or as an decimal percentage.

If percent is 37.5% a regular percentage would be expressed as 37.5 while the decimal percentage will be expressed .375.

Example:

var boxWidthPer:Percent = new Percent();
this.boxWidthPer.setPercentage(25);

this.box_mc._width *= boxWidthPer.getDecimalPercentage();

Summary

Constructor

Percent

Instance properties

Instance properties inherited from CoreObject

$instanceDescription

Instance methods

setPercentage
getPercentage
setDecimalPercentage
getDecimalPercentage
equals
clone
destroy

Instance methods inherited from CoreObject

$setClassDescription destroy toString

Constructor

Percent

function Percent (percentage:Number, isDecimalPercentage:Boolean)

Creates a new percentage class with the option of defining the percent on creation.

Parameters:

percentage :

[optional] Percent formated at a percentage or an decimal percentage.

isDecimalPercentage:

[optional] Indicates if the parameter percentage is a decimal percentage true, or regular percentage false; defaults to true.

Instance methods

clone

function clone () : Percent

Returns:

A new percent object with the same value as this percent.

destroy

function destroy () : Void

Overrides:

org.casaframework.core.CoreObject.destroy

equals

function equals (percent:Percent) : Boolean

Determines whether the percent specified in the percent parameter is equal to this percent object.

Parameters:

percent:

A defined Percent object.

Returns:

Returns true if percents are identical; otherwise false.

getDecimalPercentage

function getDecimalPercentage () : Number

Gets the percentage.

Returns:

Returns percent expressed as a decimal percentage. 37.5% would be returned as .375.

getPercentage

function getPercentage () : Number

Gets the percentage.

Returns:

Returns percent expressed as a regular percentage. 37.5% would be returned as 37.5.

setDecimalPercentage

function setDecimalPercentage (percent:Number) : Void

Sets the percentage.

Parameters:

percent:

Percent expressed as a decimal percentage. 37.5% would be expressed as .375.

setPercentage

function setPercentage (percent:Number) : Void

Sets the percentage.

Parameters:

percent:

Percent expressed as a regular percentage. 37.5% would be expressed as 37.5.