new.c File Reference

Memory allocation and deallocation definitions. More...

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include "rnr/rnrconfig.h"
#include "rnr/new.h"

Go to the source code of this file.

Functions
void *	new (size_t size)
	new() "operator" More...
void *	new_overs (void *pSrc, size_t sizeDup, size_t sizeNew)
	Allocate and duplicate. More...
void *	new_memdup (size_t size, void *data)
	Duplicate data. More...
char *	new_strdup (const char *s)
	Duplicate a string. More...
char *	new_strndup (const char *s, size_t n)
	Duplicate not more than n characters of string. More...

Detailed Description

Memory allocation and deallocation definitions.

LastChangedDate

2010-03-24 10:19:36 -0600 (Wed, 24 Mar 2010)

Rev

307

General purpose dynamic memory allocate and deallocate definitions. None of the calls will fail, unless fatally for the entire program. Modeled on C++ new() and delete() operators.

The current implementation uses the malloc() and free() standard library calls.

Author

Robin Knight (robin.nosp@m..kni.nosp@m.ght@r.nosp@m.oadn.nosp@m.arrow.nosp@m.s.co.nosp@m.m)

Copyright

© 2005-2018. RoadNarrows LLC..
http://www.roadnarrows.com
All Rights Reserved

Definition in file new.c.

Function Documentation

void* new

(

size_t

size

)

new() "operator"

Dynamic memory allocator. All allocated data are zero'ed (i.e. set to 0).

Parameters

size	Number of bytes.

Returns

Return void * to newly allocated memory. Memory is zero'ed.

Exceptions

Bad Allocation

Program is terminated with exit code EC_ERROR.

Definition at line 73 of file new.c.

References EC_ERROR, and NULL.

{
  void  *p;

  if( size == 0 )
  {
    size = 1;
  }

  if( (p = malloc(size)) == NULL )
  {
    fprintf(stderr, "new(): malloc() failed\n");
    exit(EC_ERROR);
  }
  memset(p, 0, size);
  return p;
}

void* new_memdup	(	size_t	size,
		void *	data
	)

Duplicate data.

Parameters

size	Number of bytes.
data	Data to duplicate

Returns

Return pointer to duplicated memory.

Exceptions

Bad Allocation

Program is terminated with exit code EC_ERROR.

Note

If size is zero or data is NULL, one byte is allocated.

Definition at line 146 of file new.c.

References NULL.

Referenced by delete().

{
  void *p;

  if( (size == 0) || (data == NULL) )
  {
    p = (void *)new((size_t)1);
    memset(p, 0, (size_t)1);
  }
  else
  {
    p = new(size);
    memcpy(p, data, size);
  }
  return p;
}

void* new_overs	(	void *	pSrc,
		size_t	sizeDup,
		size_t	sizeNew
	)

Allocate and duplicate.

A new block a memory of sizeNew bytes is allocated. sizeDup bytes from the source data are copied to the new block. All allocated, but not duplicated data are zero'ed (i.e. set to 0).

Note

The actual size of source block is assumed to be >= sizeDup.

Parameters

pSrc	Source memory block to duplicate.
sizeDup	Number of bytes to duplicate, with sizeDup <= sizeNew.
sizeNew	Number of bytes for new block.

Returns

Return void * to newly allocated and duplicated memory.

Exceptions

Bad Allocation	Program is terminated with exit code EC_ERROR.
Bad Sizes	Program is terminated with exit code EC_ERROR.

Definition at line 112 of file new.c.

References EC_ERROR.

Referenced by delete(), grow_table(), and shrink_table().

{
  void  *pNew;
  
  if( sizeDup > sizeNew )
  {
    fprintf(stderr, "new_overs(): duplicate size %lu > allocated size %lu\n",
        (unsigned long)sizeDup, (unsigned long)sizeNew);
    exit(EC_ERROR);
  }

  pNew = new(sizeNew);

  if( sizeDup > 0 )
  {
    memcpy(pNew, pSrc, sizeDup);
  }

  return pNew;
}

char* new_strdup

(

const char *

s

)

Duplicate a string.

Parameters

s	Null terminated string to duplicate.

Returns

Return pointer to duplicated string.

Exceptions

Bad Allocation

Program is terminated with exit code EC_ERROR.

Note

Guaranteed to return a null terminated string. If string is NULL, one byte is allocated (== 0).

Definition at line 176 of file new.c.

References NEWSTR, and NULL.

Referenced by ConfigDbNew(), ConfigDbSetName(), ConfigSectionAddPair(), ConfigSectionNew(), delete(), force_grow(), LOG_ATTACH_LOGFP(), LOG_SET_LOGFILE(), LOGGER(), LOGGER_CALL(), main(), NewExpandTilde(), NewNormPath(), NewZooAnimal(), OptsCvtArgStr(), SocketAddrName(), SocketAttrSetLocalName(), SocketAttrSetRemoteName(), SocketThisHostName(), test_hash(), UriParseNew(), UriSetHostName(), UriSetPath(), and UriSetScheme().

{
  char *t;

  if( (s != NULL) && (*s != 0) )
  {
    t = NEWSTR(strlen(s));
    strcpy(t, s);
  }
  else
  {
    t = NEWSTR(1);
    t[0] = 0;
  }
  return t;
}

char* new_strndup	(	const char *	s,
		size_t	n
	)

Duplicate not more than n characters of string.

Duplicate the first n characters of string or until a null character is encounter, whichever comes first. Guaranteed to return a null terminated string.

Parameters

s	String to duplicate.
n	Maximum number of characters to duplicate.

Exceptions

Bad Allocation

Program is terminated with exit code EC_ERROR.

Returns

Return pointer to duplicated string.

Definition at line 208 of file new.c.

References NEWSTR, and NULL.

Referenced by delete(), NewSearchPathExpanded(), UriParseHostNew(), and UriParseNew().

{
  char *t;

  if( (s != NULL) && (*s != 0) && (n > 0) )
  {
    t = NEWSTR(n+1);
    strncpy(t, s, n);
    t[n] = 0;
  }
  else
  {
    t = NEWSTR(1);
    t[0] = 0;
  }
  return t;
}