//-
// ==========================================================================
// Copyright (C) 1995 - 2006 Autodesk, Inc. and/or its licensors.  All 
// rights reserved.
//
// The coded instructions, statements, computer programs, and/or related 
// material (collectively the "Data") in these files contain unpublished 
// information proprietary to Autodesk, Inc. ("Autodesk") and/or its 
// licensors, which is protected by U.S. and Canadian federal copyright 
// law and by international treaties.
//
// The Data is provided for use exclusively by You. You have the right 
// to use, modify, and incorporate this Data into other products for 
// purposes authorized by the Autodesk software license agreement, 
// without fee.
//
// The copyright notices in the Software and this entire statement, 
// including the above license grant, this restriction and the 
// following disclaimer, must be included in all copies of the 
// Software, in whole or in part, and all derivative works of 
// the Software, unless such copies or derivative works are solely 
// in the form of machine-executable object code generated by a 
// source language processor.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. 
// AUTODESK DOES NOT MAKE AND HEREBY DISCLAIMS ANY EXPRESS OR IMPLIED 
// WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF 
// NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR 
// PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE, OR 
// TRADE PRACTICE. IN NO EVENT WILL AUTODESK AND/OR ITS LICENSORS 
// BE LIABLE FOR ANY LOST REVENUES, DATA, OR PROFITS, OR SPECIAL, 
// DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES, EVEN IF AUTODESK 
// AND/OR ITS LICENSORS HAS BEEN ADVISED OF THE POSSIBILITY 
// OR PROBABILITY OF SUCH DAMAGES.
//
// ==========================================================================
//+

#include <utilEngine.h>

/*
//	Function Name:
//		engineUtilStringsMatch
//
//	Description:
//		A helper function to compare two strings
//
//  Input Arguments:
//		EtByte *string1				The first string to compare
//		EtByte *string2				The second string to compare
//
//  Return Value:
//      EtBoolean result			A handle for the opened file
//			kEngineTRUE					the two strings match
//			kEngineFALSE				the two strings do not match
*/
EtBoolean
engineUtilStringsMatch (EtByte *string1, EtByte *string2)
{
	/* make sure both strings are valid */
	if ((string1 == kEngineNULL) || (string2 == kEngineNULL)) {
		return (kEngineFALSE);
	}
	/* just in case both pointers are the same */
	if (string1 == string2) {
		return (kEngineTRUE);
	}
	/* compare the two strings */
	return (strcmp ((const char *)string1, (const char *)string2) == 0);
}

/*
//	Function Name:
//		engineUtilCopyString
//
//	Description:
//		A helper function to copy one string to another
//
//  Input Arguments:
//		EtByte *src					The string to copy
//		EtByte *dest				The string destination
//
//  Return Value:
//		None
*/
EtVoid
engineUtilCopyString (EtByte *src, EtByte *dest)
{
	/* make sure both strings are valid */
	if ((src == kEngineNULL) || (dest == kEngineNULL)) {
		return;
	}
	/* copy the string */
	strcpy ((char *)dest, (const char *)src);
}

/*
//	Function Name:
//		engineUtilAllocate
//
//	Description:
//		A helper function to allocate a block of memory
//
//  Input Arguments:
//		EtInt bytes					The number of bytes to allocate
//
//  Return Value:
//		EtByte *block				A pointer to the requested memory block
*/
EtByte *
engineUtilAllocate (EtInt bytes)
{
	return (malloc (bytes));
}

/*
//	Function Name:
//		engineUtilFree
//
//	Description:
//		A helper function to free a block of memory allocated using
//	engineUtilAllocate
//
//  Input Arguments:
//		EtByte *block				A pointer to the memory block to free
//
//  Return Value:
//		None
*/
EtVoid
engineUtilFree (EtByte *block)
{
	if (block != kEngineNULL) {
		free (block);
	}
}