ajmem.c

Function ajMemAlloc

Prototype

void* ajMemAlloc (
      size_t nbytes,
      const char* file,
      ajint line,
      AjBool nofail
);

Type	Name	Read/Write	Description
size_t	nbytes	Input	Number of bytes required
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
AjBool	nofail	Input	If true, return with a NULL pointer when unable to allocate.
void*		RETURN	Successfully allocated memory, or NULL on failure. Normal behaviour is to raise an exception and fail, or if running with Java, to print to standard error and exit.

From EMBOSS 1.0.0

Function ajMemCalloc

Prototype

void* ajMemCalloc (
      size_t count,
      size_t nbytes,
      const char* file,
      ajint line,
      AjBool nofail
);

Type	Name	Read/Write	Description
size_t	count	Input	Number of elements required
size_t	nbytes	Input	Number of bytes required per element
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
AjBool	nofail	Input	If true, return with a NULL pointer when unable to allocate.
void*		RETURN	Successfully allocated memory, or NULL on failure. Normal behaviour is to raise an exception and fail, or if running with Java, to print to standard error and exit.

From EMBOSS 1.0.0

Function ajMemCallocZero

Prototype

void* ajMemCallocZero (
      size_t count,
      size_t nbytes,
      const char* file,
      ajint line,
      AjBool nofail
);

Type	Name	Read/Write	Description
size_t	count	Input	Number of elements required
size_t	nbytes	Input	Number of bytes required
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
AjBool	nofail	Input	If true, return with a NULL pointer when unable to allocate.
void*		RETURN	Successfully allocated memory, or NULL on failure. Normal behaviour is to raise an exception and fail, or if running with Java, to print to standard error and exit.

From EMBOSS 6.0.0

Function ajMemSetZero

Prototype

void ajMemSetZero (
      void* ptr,
      size_t count,
      size_t nbytes
);

Type	Name	Read/Write	Description
void*	ptr	Modify	Pointer to memory previously allocated with 'malloc'
size_t	count	Input	Number of elements required
size_t	nbytes	Input	Number of bytes required
void		RETURN

From EMBOSS 6.0.0

Function ajMemFree

Prototype

void ajMemFree (
      void** ptr
);

From EMBOSS 1.0.0

---

Function ajMemResize

Resizes previously allocated memory, and ensures data is copied to the new location if it is moved.

Prototype

void* ajMemResize (
      void* ptr,
      size_t nbytes,
      const char* file,
      ajint line,
      AjBool nofail
);

Type	Name	Read/Write	Description
void**	ptr	Modify	Pointer to memory previously allocated with 'malloc'
void*	ptr	Modify	Pointer to memory previously allocated with 'malloc'
size_t	nbytes	Input	Number of bytes required
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
AjBool	nofail	Input	If true, return with a NULL pointer when unable to allocate.
void*		RETURN	Successfully reallocated memory, or NULL on failure. Normal behaviour is to raise an exception and fail, or if running with Java, to print to standard error and exit.

From EMBOSS 1.0.0

Function ajMemResizeZero

Prototype

void* ajMemResizeZero (
      void* ptr,
      size_t oldbytes,
      size_t nbytes,
      const char* file,
      ajint line,
      AjBool nofail
);

Type	Name	Read/Write	Description
void*	ptr	Modify	Pointer to memory previously allocated with 'malloc'
size_t	oldbytes	Input	Number of bytes required
size_t	nbytes	Input	Number of bytes required
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
AjBool	nofail	Input	If true, return with a NULL pointer when unable to allocate.
void*		RETURN	Successfully reallocated memory, or NULL on failure. Normal behaviour is to raise an exception and fail, or if running with Java, to print to standard error and exit.

From EMBOSS 6.0.0

Function ajMemArrB

Prototype

ajint* ajMemArrB (
      size_t size
);

Type	Name	Read/Write	Description
size_t	size	Input	Number of array elements.
ajint*		RETURN	Newly allocated array.

From EMBOSS 1.0.0

Function ajMemArrI

Prototype

ajint* ajMemArrI (
      size_t size
);

Type	Name	Read/Write	Description
size_t	size	Input	Number of array elements.
ajint*		RETURN	Newly allocated array.

From EMBOSS 1.0.0

Function ajMemArrF

Prototype

float* ajMemArrF (
      size_t size
);

Type	Name	Read/Write	Description
size_t	size	Input	Number of array elements.
float*		RETURN	Newly allocated array.

From EMBOSS 1.0.0

Function ajMemStat

Prototype

void ajMemStat (
      const char* title
);

Type	Name	Read/Write	Description
const char*	title	Input	Title for this summary
void		RETURN

From EMBOSS 1.0.0

Function ajMemExit

Prototype

void ajMemExit (
      void
);

Type	Name	Read/Write	Description
void		RETURN

From EMBOSS 1.0.0

Function ajMemCheck

Prototype

void ajMemCheck (
      int istat
);

Type	Name	Read/Write	Description
int	istat	Input	Enumerated value from mprobe
void		RETURN

From EMBOSS 6.0.0

Function ajMemCheckSetLimit

Prototype

void ajMemCheckSetLimit (
      ajint maxfail
);

Type	Name	Read/Write	Description
ajint	maxfail	Input	Maximum failures allowed
void		RETURN

From EMBOSS 6.0.0

Function ajMemProbe

Prototype

void ajMemProbe (
      void* ptr,
      const char* file,
      ajint line
);

Type	Name	Read/Write	Description
void*	ptr	Modify	Pointer to memory previously allocated with 'malloc'
const char*	file	Input	Source file name, generated by a macro.
ajint	line	Input	Source line number, generated by a macro.
void		RETURN

From EMBOSS 6.0.0