This commit is contained in:
hyung-hwan 2008-08-18 08:51:40 +00:00
parent 5f8b7ead34
commit 63014b5fc8
3 changed files with 85 additions and 56 deletions

View File

@ -1,5 +1,5 @@
/*
* $Id: mem.h 330 2008-08-16 15:29:33Z baconevi $
* $Id: mem.h 331 2008-08-17 14:51:40Z baconevi $
*
* {License}
*/
@ -10,18 +10,21 @@
#include <ase/types.h>
#include <ase/macros.h>
/* gets the default memory manager */
#define ASE_MMGR_GETDFL() (ase_mmgr)
/* gets a pointer to the default memory manager */
#define ASE_MMGR_GETDFLMMGR() (ase_mmgr)
/* sets the default memory manager */
#define ASE_MMGR_SETDFL(m) ((ase_mmgr)=(m))
/* sets a pointer to the default memory manager */
#define ASE_MMGR_SETDFLMMGR(m) ((ase_mmgr)=(m))
/* allocate a memory block */
#define ASE_MMGR_ALLOC(mmgr,size) \
(mmgr)->malloc((mmgr)->custom_data,size)
/* reallocate a memory block */
#define ASE_MMGR_REALLOC(mmgr,ptr,size) \
(mmgr)->realloc((mmgr)->custom_data,ptr,size)
/* free a memory block */
#define ASE_MMGR_FREE(mmgr,ptr) \
(mmgr)->free((mmgr)->custom_data,ptr)
@ -30,7 +33,7 @@ extern "C" {
#endif
/*
* NAME: point to the default memory manager
* NAME: holds a pointer to the default memory manager
*
* DESCRIPTION:
* The ASE_MMGR_GETDFL() macro returns the default memory manager.
@ -39,60 +42,60 @@ extern "C" {
extern ase_mmgr_t* ase_mmgr;
/*
* NAME: copy memory area
* NAME: copy a memory block
*
* DESCRIPTION:
* The ase_memcpy() functions copies n bytes from the source memory area src
* to the destinaion memory area dst.
* The ase_memcpy() functions copies n bytes from the source memory block src
* to the destinaion memory block dst.
*
* RETURNS: the destination memory area dst.
* RETURNS: the destination memory block dst.
*
* WARNING:
* The memory areas should not overlap. Use the ase_memmove() function if
* The memory blocks should not overlap. Use the ase_memmove() function if
* they overlap.
*/
void* ase_memcpy (
void* dst /* a pointer to the destination memory area */ ,
const void* src /* a pointer to the source memory area */ ,
void* dst /* a pointer to the destination memory block */ ,
const void* src /* a pointer to the source memory block */ ,
ase_size_t n /* the number of bytes to copy */
);
/*
* NAME: copy memory area with more care
* NAME: copy a memory block with more care
*
* DESCRIPTION:
* The ase_memmove() functions copies n bytes from the source memory area src
* to the destinaion memory area dst without corrupting overlapping zone.
* The ase_memmove() functions copies n bytes from the source memory block src
* to the destinaion memory block dst without corrupting overlapping zone.
*
* RETURNS: the destination memory area dst.
* RETURNS: the destination memory block dst.
*/
void* ase_memmove (
void* dst /* a pointer to the destination memory area */,
const void* src /* a pointer to the source memory area */,
void* dst /* a pointer to the destination memory block */,
const void* src /* a pointer to the source memory block */,
ase_size_t n /* the number of bytes to copy */
);
/*
* NAME: fill memory area
* NAME: fill a memory block
*
* DESCRIPTION:
* The ase_memset() function fills leading n bytes of the destination
* memory area dst with the byte val.
* memory block dst with the byte val.
*
* RETURNS: the destination memory area dst
* RETURNS: the destination memory block dst
*/
void* ase_memset (
void* dst /* a pointer to the destination memory area */,
int val /* the byte to fill the memory area with */,
void* dst /* a pointer to the destination memory block */,
int val /* the byte to fill the memory block with */,
ase_size_t n /* the number of bytes to fill */
);
/*
* NAME: compare memory areas
* NAME: compare memory blocks
*
* DESCRIPTION:
* The ase_memcmp() function compares leading n bytes of two memory areas
* The ase_memcmp() function compares leading n bytes of two memory blocks
* s1 and s2.
*
* RETURNS:
@ -102,61 +105,61 @@ void* ase_memset (
* a negative number if the first different byte of s1 is less than that of s2.
*/
int ase_memcmp (
const void* s1 /* a pointer to the first memory area to compare */,
const void* s2 /* a pointer to the second memory area to compare */,
const void* s1 /* a pointer to the first memory block to compare */,
const void* s2 /* a pointer to the second memory block to compare */,
ase_size_t n /* the number of bytes to compare */
);
/*
* NAME: find a byte forward in memory area
* NAME: find a byte forward in a memory block
*
* DESCRIPTION:
* The ase_membyte() function scans the memory area s from the first byte
* The ase_membyte() function scans the memory block s from the first byte
* up to the nth byte in search of the byte val. If it finds a match,
* it aborts scanning the memory area and returns the pointer to the matching
* it aborts scanning the memory block and returns the pointer to the matching
* location.
*
* RETURNS:
* ASE_NULL if the byte val is not found.
* The pointer to the location in the memory area s matching the byte val
* The pointer to the location in the memory block s matching the byte val
* if a match is found.
*/
void* ase_membyte (
const void* s /* a pointer to the memory area to scan */,
const void* s /* a pointer to the memory block to scan */,
int val /* a byte to find */,
ase_size_t n /* the number of bytes to scan */
);
/*
* NAME: find a byte backward in memory area
* NAME: find a byte backward in a memory block
*
* DESCRIPTION:
* The ase_memrbyte() function scans the memory area s from the nth byte
* The ase_memrbyte() function scans the memory block s from the nth byte
* backward to the first byte in search of the byte val. If it finds a match,
* it aborts scanning the memory area and returns the pointer to the matching
* it aborts scanning the memory block and returns the pointer to the matching
* location.
*
* RETURNS:
* ASE_NULL if the byte val is not found.
* The pointer to the location in the memory area s matching the byte val
* The pointer to the location in the memory block s matching the byte val
* if a match is found.
*/
void* ase_memrbyte (
const void* s /* a pointer to the memory area to scan */,
const void* s /* a pointer to the memory block to scan */,
int val /* a byte to find */,
ase_size_t n /* the number of bytes to scan */
);
/*
* NAME: find a block of bytes forward in memory area
* NAME: find a block of bytes forward in a memory block
*
* DESCRIPTION:
* The ase_memmem() functions scans the first hl bytes of the memory area hs
* The ase_memmem() functions scans the first hl bytes of the memory block hs
* in search of the byte block nd of the length nl bytes.
*
* RETURNS:
* ASE_NULL if the byte val is not found.
* The pointer to the location in the memory area s matching the byte val
* The pointer to the location in the memory block s matching the byte val
* if a match is found.
*
* RETURNS:
@ -164,17 +167,17 @@ void* ase_memrbyte (
* The pointer to the start of the matching location if a match is found.
*/
void* ase_memmem (
const void* hs /* a pointer to the memory area to scan */,
const void* hs /* a pointer to the memory block to scan */,
ase_size_t hl /* the number of bytes to scan */,
const void* nd /* a pointer to the byte block to find */,
ase_size_t nl /* the number of bytes in the block */
);
/*
* NAME: find a block of bytes backward in memory area
* NAME: find a block of bytes backward in a memory block
*
* DESCRIPTION:
* The ase_memrmem() functions scans the first hl bytes of the memory area hs
* The ase_memrmem() functions scans the first hl bytes of the memory block hs
* backward in search of the byte block nd of the length nl bytes.
*
* RETURNS:
@ -182,7 +185,7 @@ void* ase_memmem (
* The pointer to the start of the matching location if a match is found.
*/
void* ase_memrmem (
const void* hs /* a pointer to the memory area to scan */,
const void* hs /* a pointer to the memory block to scan */,
ase_size_t hl /* the number of bytes to scan */,
const void* nd /* a pointer to the byte block to find */,
ase_size_t nl /* the number of bytes in the block */

View File

@ -68,21 +68,39 @@ extern "C" {
#endif
/*
* NAME creates a new singly linked list
* RETURNS a pointer to a newly created singly linked list
* NAME: creates a singly linked list
*
* DESCRIPTION:
* The ase_sll_open() functions creates an empty singly linked list with
* the default memory manager.
*
* RETURNS: a pointer to a newly created singly linked list
*/
ase_sll_t* ase_sll_open (
ase_sll_t* ase_sll_open (void);
/*
* NAME: create a singly linked list with a custom memory manager
*/
ase_sll_t* ase_sll_openm (
ase_mmgr_t* mmgr /* memory manager */
);
/*
* NAME: create a singly linked list securing extension area
*/
ase_sll_t* ase_sll_openx (
ase_size_t extension /* size of extension in bytes */,
ase_fuser_t initializer /* extension initializer */
);
/*
* NAME creates a new singly linked list with extension
* RETURNS a pointer to a newly created singly linked list
*/
ase_sll_t* ase_sll_openx (
ase_sll_t* ase_sll_openmx (
ase_mmgr_t* mmgr /* memory manager */ ,
ase_size_t extension /* size of extension in bytes */,
ase_fuser_t fuser
ase_fuser_t initializer /* extension initializer */
);
/*

View File

@ -13,16 +13,23 @@ void* ase_sll_copyinline (ase_sll_t* sll, void* dptr, ase_size_t dlen)
return ASE_NULL;
}
ase_sll_t* ase_sll_open ()
ase_sll_t* ase_sll_open (void)
{
return ase_sll_openx (ASE_MMGR_GETDFLMMGR(), 0, ASE_NULL);
}
ase_sll_openm (ase_mmgr_t* mmgr)
{
return ase_sll_openx (mmgr, 0, ASE_NULL);
}
ase_sll_openm (ase_mmgr_t* mmgr);
ase_sll_openx (ase_size_t extension, ase_fuser_t fuser);
ase_sll_openx (ase_size_t extension, ase_fuser_t initializer)
{
return ase_sll_openx (mmgr, 0, ASE_NULL);
}
ase_sll_t* ase_sll_openf (
ase_mmgr_t* mmgr, ase_size_t extension, ase_fuser_t fuser)
ase_sll_t* ase_sll_openmx (
ase_mmgr_t* mmgr, ase_size_t extension, ase_fuser_t initializer)
{
ase_sll_t* sll;
@ -32,9 +39,10 @@ ase_sll_t* ase_sll_openf (
if (sll == ASE_NULL) return ASE_NULL;
ASE_MEMSET (sll, 0, ASE_SIZEOF(ase_sll_t) + extension);
if (fuser != ASE_NULL) mmgr = fuser (mmgr, sll + 1);
sll->mmgr = mmgr;
if (initializer != ASE_NULL) mmgr = initializer (sll, sll + 1);
return sll;
}