list_8c.tex

用C写的十分精巧的XML实现程序库

\section{F:/Lab/XML/minixml/list.c File Reference}
\label{list_8c}\index{F:/Lab/XML/minixml/list.c@{F:/Lab/XML/minixml/list.c}}
C list implementation. 

{\tt \#include $<$memory.h$>$}\par
{\tt \#include $<$stdlib.h$>$}\par
{\tt \#include $<$assert.h$>$}\par
{\tt \#include $<$stdio.h$>$}\par
{\tt \#include \char`\"{}list.h\char`\"{}}\par
\subsection*{Functions}
\begin{CompactItemize}
\item 
{\bf list\-Ptr} {\bf create\-List} ()
\begin{CompactList}\small\item\em create a new list strut \item\end{CompactList}\item 
{\bf link\-Ptr} {\bf add\-Link} ({\bf list\-Ptr} {\bf list}, void $\ast$data)
\begin{CompactList}\small\item\em create a new list strut \item\end{CompactList}\item 
void {\bf destroy\-List} ({\bf list\-Ptr} $\ast$list\-Ptr\-Ptr, {\bf free\-User\-Data} on\-Free\-Data)
\begin{CompactList}\small\item\em destroy a list \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
C list implementation. 

(C) 2007 GEC All rights reserved.

\begin{Desc}
\item[Author:]Deng Yangjun \end{Desc}
\begin{Desc}
\item[Date:]2006-1-28 \end{Desc}


\subsection{Function Documentation}
\index{list.c@{list.c}!addLink@{addLink}}
\index{addLink@{addLink}!list.c@{list.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf link\-Ptr} add\-Link ({\bf list\-Ptr} {\em list}, void $\ast$ {\em data})}\label{list_8c_c957c98da6030a0a65f935448b446d55}


create a new list strut 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em list}][in,out]list that will be add the new link \item[{\em data}][in]value of the new link \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the new link 's point, can't free it, please free it by destroy\-List or remove\-Link \end{Desc}
\index{list.c@{list.c}!createList@{createList}}
\index{createList@{createList}!list.c@{list.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf list\-Ptr} create\-List ()}\label{list_8c_05d3366e4e8eb7ff831ba4033d7e0d70}


create a new list strut 

\begin{Desc}
\item[Returns:]new list pointer, you MUST release it by destroy\-List(list\-Ptr list) \end{Desc}
\index{list.c@{list.c}!destroyList@{destroyList}}
\index{destroyList@{destroyList}!list.c@{list.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void destroy\-List ({\bf list\-Ptr} $\ast$ {\em list\-Ptr\-Ptr}, {\bf free\-User\-Data} {\em on\-Free\-Data})}\label{list_8c_47f7346a9121c80f3c2ee76307399a2b}


destroy a list 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em list\-Ptr\-Ptr}][in,out] list that will be destroyed, after the function, the list's pointer will be NULL \item[{\em on\-Free\-Data}][in] register user data free hander function. when destroy link, it will be invoked. if you don't need to free user data, you can set it NULL \end{description}
\end{Desc}