server-1.12/common/links.c

102 lines
2.4 KiB
C

/*
* static char *rcsid_friend_c =
* "$Id: links.c 11578 2009-02-23 22:02:27Z lalo $";
*/
/*
CrossFire, A Multiplayer game for X-windows
Copyright (C) 1992 Frank Tore Johansen
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
The author can be reached via e-mail to frankj@ifi.uio.no.
*/
/**
* @file links.c
* Utility functions for links between objects.
*/
#include <global.h>
/**
* Allocates a new objectlink structure, initialises it, and returns
* a pointer to it.
*
* @note
* will call fatal() if memory allocation failure, thus never return NULL.
*
* @return
* new link object, cleared.
*/
objectlink *get_objectlink(void) {
objectlink *ol = (objectlink *)CALLOC(1, sizeof(objectlink));
if (!ol)
fatal(OUT_OF_MEMORY);
ol->ob = NULL;
ol->next = NULL;
ol->id = 0;
return ol;
}
/**
* Allocates a new oblinkpt structure, initialises it, and returns
* a pointer to it.
*
* @note
* will call fatal() if memory allocation failure, thus never return NULL.
*
* @return
* new link pointer.
*/
oblinkpt *get_objectlinkpt(void) {
oblinkpt *obp = (oblinkpt *)malloc(sizeof(oblinkpt));
if (!obp)
fatal(OUT_OF_MEMORY);
obp->link = NULL;
obp->next = NULL;
obp->value = 0;
return obp;
}
/**
* Recursively frees all objectlinks.
*
* @param ol
* object link to free.
*/
void free_objectlink(objectlink *ol) {
if (ol->next)
free_objectlink(ol->next);
free(ol);
}
/**
* Recursively frees all linked list of objectlink pointers
*
* @param obp
* pointer to free.
*/
void free_objectlinkpt(oblinkpt *obp) {
if (obp->next)
free_objectlinkpt(obp->next);
if (obp->link)
free_objectlink(obp->link);
free(obp);
}