db/dbmi_base/alloc.c

Go to the documentation of this file.

/*!
   \file lib/db/dbmi_base/alloc.c
 
   \brief DBMI Library (base) - allocate memory
 
   (C) 1999-2009, 2011 by the GRASS Development Team
 
   This program is free software under the GNU General Public License
   (>=v2). Read the file COPYING that comes with GRASS for details.
 
   \author Joel Jones (CERL/UIUC), Radim Blazek
   \author Doxygenized by Martin Landa <landa.martin gmail.com> (2011)
 */
 
#include <string.h>
#include <stdlib.h>
#include <grass/dbmi.h>
 
/*!
   \brief Make a copy of string buffer
 
   Allocated string buffer should be freed by db_free().
 
   \param s source string buffer
 
   \return allocated string buffer
 */
char *db_store(const char *s)
{
    char *a;
 
    a = db_malloc(strlen(s) + 1);
    if (a)
        strcpy(a, s);
    return a;
}
 
/*!
   \brief Allocate memory
 
   On failure is called db_memory_error().
 
   \param n number of bytes to be allocated
 
   \return pointer to allocated memory
 */
void *db_malloc(int n)
{
    void *s;
 
    if (n <= 0)
        n = 1;
    s = malloc((unsigned int)n);
    if (s == NULL)
        db_memory_error();
    return s;
}
 
/*!
   \brief Allocate memory
 
   On failure is called db_memory_error().
 
   \param n number of entities
   \param m entity size
 
   \return pointer to allocated memory
 */
void *db_calloc(int n, int m)
{
    void *s;
 
    if (n <= 0)
        n = 1;
    if (m <= 0)
        m = 1;
    s = calloc((unsigned int)n, (unsigned int)m);
    if (s == NULL)
        db_memory_error();
    return s;
}
 
/*!
   \brief Reallocate memory
 
   On failure is called db_memory_error().
 
   \param s pointer to memory
   \param n number of newly allocated bytes
 
   \return pointer to allocated memory
 */
void *db_realloc(void *s, int n)
{
    if (n <= 0)
        n = 1;
    if (s == NULL)
        s = malloc((unsigned int)n);
    else
        s = realloc(s, (unsigned int)n);
    if (s == NULL)
        db_memory_error();
    return s;
}
 
/*!
   \brief Free allocated memory
 
   \param s pointer to memory to be freed
 */
void db_free(void *s)
{
    free(s);
}