kplayer/kplayer/exswift/Float.swift

//
//  Float.swift
//  ExSwift
//
//  Created by pNre on 04/06/14.
//  Copyright (c) 2014 pNre. All rights reserved.
//

import Foundation

public extension Float {

    /**
        Absolute value.
        
        :returns: fabs(self)
    */
    func abs () -> Float {
        return fabsf(self)
    }

    /**
        Squared root.
    
        :returns: sqrtf(self)
    */
    func sqrt () -> Float {
        return sqrtf(self)
    }
    
    /**
        Rounds self to the largest integer <= self.
    
        :returns: floorf(self)
    */
    func floor () -> Float {
        return floorf(self)
    }
    
    /**
        Rounds self to the smallest integer >= self.
    
        :returns: ceilf(self)
    */
    func ceil () -> Float {
        return ceilf(self)
    }
    
    /**
        Rounds self to the nearest integer.
    
        :returns: roundf(self)
    */
    func round () -> Float {
        return roundf(self)
    }
        
    /**
        Clamps self to a specified range.
    
        :param: min Lower bound
        :param: max Upper bound
        :returns: Clamped value
    */
    func clamp (min: Float, _ max: Float) -> Float {
        return Swift.max(min, Swift.min(max, self))
    }
    
    /**
        Random float between min and max (inclusive).
    
        :param: min
        :param: max
        :returns: Random number
    */
    static func random(min: Float = 0, max: Float) -> Float {
        let diff = max - min;
        let rand = Float(arc4random() % (UInt32(RAND_MAX) + 1))
        return ((rand / Float(RAND_MAX)) * diff) + min;
    }
    
}