| iMatix home page | << | < | > | >>

SFL Version 2.11

Memory allocation functions

Filename: sflmem.h
Package: Standard Function Library (SFL)
Written: 1996/06/08 iMatix SFL project team sfl@imatix.com
Revised: 1999/12/28
Copyright: Copyright (c) 1996-2000 iMatix Corporation

Synopsis

Encapsulated memory allocation functions. Based on an article by Jim Schimandle in DDJ August 1990. Provides 'safe' versions of malloc(), realloc(), free(), and strdup(). These functions protect the programmer from errors in calling memory allocation/free routines. When these calls are used, the allocation routines in this module add a data structure to the top of allocated memory blocks which tags them as legal memory blocks. When the free routine is called, the memory block to be freed is checked for legality. If the block is not legal, the memory list is dumped to stderr and the program is terminated. Some of these functions are called through macros that add the filename and line number of the call, for tracing. Do not call these functions directly.

List of Functions

• void * mem alloc
  (MEMTRN *trn, size_t size, const char *source_file, size_t source_line);
• void * mem realloc
  (void *block, size_t size, const char *source_file, size_t source_line);
• void mem free
  (void *block, const char *source_file, size_t source_line);
• char * mem strdup
  (MEMTRN *trn, const char *string, const char *source_file, size_t source_line);
• void mem strfree
  (char **string, const char *source_file, size_t source_line);
• DESCR * mem descr
  (MEMTRN *trn, const void *block, size_t size, const char *source_file, size_t source_line);
• MEMTRN * mem new trans
  (const char *source_file, size_t source_line);
• void mem commit
  (MEMTRN *trn, const char *source_file, size_t source_line);
• void mem rollback
  (MEMTRN *trn, const char *source_file, size_t source_line);
• void mem checkall
  (const char *source_file, size_t source_line);
• void mem check
  (const void *block, const char *source_file, size_t source_line);
• void mem assert
  (const char *source_file, size_t source_line);
• size_t mem size
  (const void *block, const char *source_file, size_t source_line);
• long mem used
  (void);
• long mem allocs
  (void);
• long mem frees
  (void);
• void mem freeall
  (void);
• void mem display
  (FILE *save_to);
• int mem scavenger
  (scavenger scav_fct, void *scav_arg);

List of Symbol Definitions

sflmem.h defines these symbols, possibly conditionally:

Symbol:	Defined as:
SFLMEM_INCLUDED	TRUE
mem_alloc(n)	(various)
mem_assert()	(various)
mem_check(p)	(various)
mem_checkall()	(various)
mem_commit(t)	(various)
mem_descr(p,n)	(various)
mem_free(p)	(various)
mem_new_trans()	(various)
mem_realloc(p,n)	(various)
mem_rollback(t)	(various)
mem_size(p)	(various)
mem_strdup(s)	(various)
mem_strfree(ps)	(various)
memt_alloc(t,n)	(various)
memt_descr(t,p,n)	(various)
memt_strdup(t,s)	(various)

List of Type Definitions

| << | < | > | >>

Copyright © 1996-2000 iMatix Corporation