/*

* Copyright (c) 2003 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: Internal memory management function declarations

*

*/

#ifndef __M3G_MEMORY_H__

#define __M3G_MEMORY_H__

#if defined(__cplusplus)

extern "C" {

#endif

/*!

 * \internal

 * \file

 * \brief Internal memory management function declarations

 */

#include "M3G/m3g_core.h"

#include "m3g_defs.h"

#if !defined(M3G_NO_STDLIB)

#   include <string.h>

#endif

/*----------------------------------------------------------------------

 * Internal API

 *--------------------------------------------------------------------*/

/*!

 * \internal

 * \brief Fills a block of memory with a value

 * 

 * \param ptr pointer to the block to fill

 * \param size length of the block, in bytes

 */

static M3G_INLINE void m3gFill(void *ptr, size_t size, M3Gbyte value)/*@modifies *ptr@*/

{

#if defined(M3G_NO_STDLIB)

    M3Gbyte *pb = (M3Gbyte*) ptr;

    while(size--) {

        *pb++ = value;

    }

#else

    memset(ptr, (int) value, size);

#endif

}

/*!

 * \internal

 * \brief Sets a block of memory to zero

 * 

 * \param ptr pointer to the block to zero

 * \param size length of the block, in bytes

 */

static M3G_INLINE void m3gZero(void *ptr, size_t size)/*@modifies *ptr@*/

{

    m3gFill(ptr, size, (M3Gbyte) 0);

}

/*!

 * \internal

 *  \brief Copies a block of memory

 *

 * \param ptr pointer to the block to zero

 * \param size length of the block, in bytes

 */

static M3G_INLINE void m3gCopy(

    /*@unique@*/ void *dst,

    /*@unique@*/ const void *src,

    size_t size)/*@modifies *dst@*/

{

#if defined(M3G_NO_STDLIB)

    M3Gbyte *dst = (M3Gbyte *) dst;

    const M3Gbyte *src = (const M3Gbyte *) src;

    while(size--) {

        *dst++ = *src++;

    }

#else

    memcpy(dst, src, size);

#endif

}

/*!

 * \internal

 *  \brief Moves a block of memory

 *

 * \param ptr pointer to the block to zero

 * \param size length of the block, in bytes

 */

static M3G_INLINE void m3gMove(

    /*@unique@*/ void *dst,

    /*@unique@*/ const void *src,

    size_t size)/*@modifies *dst@*/

{

#if defined(M3G_NO_STDLIB)

    M3Gbyte *dst = (M3Gbyte *) dst;

    const M3Gbyte *src = (const M3Gbyte *) src;

    if(dst <= src || (src + size) >= dst) {

	    while(size--) {

	        *dst++ = *src++;

	    }

    }

    else {

	    src += size - 1;

	    dst += size - 1;

	    while(size--) {

	        *dst-- = *src--;

	    }

	}

#else

    memmove(dst, src, size);

#endif

}

#if defined(__cplusplus)

} /* extern "C" */

#endif

#endif /*__M3G_MEMORY_H__*/