Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
libinn_list(3)		   InterNetNews Documentation		  libinn_list(3)

NAME
     list - list routines

SYNOPSIS
	 #include <inn/list.h>

	 struct node {
	     struct node *succ;
	     struct node *pred;
	 };

	 struct list {
	     struct node *head;
	     struct node *tail;
	     struct node *tailpred;
	 };

	 void list_new(struct list *list);

	 struct node *list_addhead(struct list *list, struct node *node);

	 struct node *list_addtail(struct list *list, struct node *node);

	 struct node *list_head(struct list *list);

	 struct node *list_tail(struct list *list);

	 struct node *list_succ(struct node *node);

	 struct node *list_pred(struct node *node);

	 struct node *list_remhead(struct list *list);

	 struct node *list_remtail(struct list *list);

	 struct node *list_remove(struct node *node);

	 struct node *list_insert(struct list *list, struct node *node,
				  struct node *pred);

	 bool list_isempty(struct list *list);

DESCRIPTION
     list_new initialises the list header list so as to create an empty list.

     list_addhead adds node to the head of list, returning the node just added.

     list_addtail adds node to the tail of list, returning the node just added.

     list_head	returns a pointer to the node at the head of list or NULL if the
     list is empty.

     list_tail returns a pointer to the node at the tail of list or NULL if  the
     list is empty.

     list_succ	returns the next (successor) node on the list after node or NULL
     if node was the final node.

     list_pred returns the previous (predecessor) node on the list  before  node
     or NULL if node was the first node.

     list_remhead removes the first node from list and returns it to the caller.
     If the list is empty NULL is returned.

     list_remtail  removes the last node from list and returns it to the caller.
     If the list is empty NULL is returned.

     list_remove removes node from the list it is  on  and  returns  it  to  the
     caller.

     list_insert  inserts  node  onto list after the node pred.  If pred is NULL
     then node is added to the head of list.

HISTORY
     Written by Alex Kiernan <alex.kiernan@thus.net> for InterNetNews 2.4.0.

INN 2.8.0			   2023-02-21			  libinn_list(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libinn_list&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help