/*
	DESCRIPTION	: Generic utility functions.
	NOTES		: 
*/

// ====================================================================

function getRandom(randomMin, randomMax)
{
	// Returns a random whole number in a min..max range.
	// NOTE: There should probably be an engine function for this,
	// since we'd need to keep track of random seeds for replays.

	var randomNum = randomMin + (randomMax-randomMin)*Math.random();  // num is random, from A to B 
	return Math.round(randomNum);
}

// ====================================================================

function parseDelimiterString (parseString, delimiter) 
{ 
        // Seeks through the delimiters in a string and populates the elements of an array with fields found between them. 

        // Declare local variables. 
        var parseLoop = 0; 
        var parseElement = 0; 
        var seekDelimiter = 0; 
        var parseArray = new Array(); 

        // While we're still within the bounds of the string, 
        while (parseLoop <= parseString.length) 
        { 
                // Seek until we find a delimiter. 
                seekDelimiter = parseLoop; 
                while (parseString[seekDelimiter] != delimiter && seekDelimiter <= parseString.length) 
                        seekDelimiter++; 

                // If we found a delimiter within the string, 
                if (seekDelimiter != parseString.length) 
                { 
                        // Store sub-string between start point and delimiter in array element. 
                        parseArray[parseElement] = parseString.substring(parseLoop, seekDelimiter); 
                        parseElement++; 
                } 

                // Move to after delimiter position for next seek. 
                parseLoop = seekDelimiter+1; 
        } 

        // Store length of array. 
        parseArray.length = parseElement; 

        return parseArray; 
}

// ====================================================================

function addArrayElement(Array) 
{ 
        // Adds an element to an array, updates its given index, and returns the index of the element. 

        Array[Array.last] = new Object(); 
        Array.last++; 

        return (Array.last - 1); 
} 

// ====================================================================

function toTitleCase (string)
{
	if (!string) console.write ("toTileCase(): String " + string + " has no properties.");

	// Returns the title-case version of a given string.
	string = string.toString();
	string = string.substring(0,1).toUpperCase() + string.substring(1, string.length).toLowerCase();
	return (string);
}

// ====================================================================