minixml_8c.tex

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

\section{F:/Lab/XML/minixml/minixml.c File Reference}
\label{minixml_8c}\index{F:/Lab/XML/minixml/minixml.c@{F:/Lab/XML/minixml/minixml.c}}
Mini XML lib. 

{\tt \#include $<$memory.h$>$}\par
{\tt \#include $<$stdlib.h$>$}\par
{\tt \#include $<$assert.h$>$}\par
{\tt \#include $<$stdio.h$>$}\par
{\tt \#include $<$string.h$>$}\par
{\tt \#include \char`\"{}minixml.h\char`\"{}}\par
\subsection*{Functions}
\begin{CompactItemize}
\item 
{\bf xml\-Doc\-Ptr} {\bf xml\-New\-Doc} ()
\begin{CompactList}\small\item\em \doxyref{xml\-Doc}{p.}{structxml_doc} struct pointer \item\end{CompactList}\item 
void {\bf xml\-Free\-Doc} ({\bf xml\-Doc\-Ptr} doc)
\begin{CompactList}\small\item\em free XML document struct \item\end{CompactList}\item 
void {\bf xml\-Free\-Node} ({\bf xml\-Node\-Ptr} node)
\begin{CompactList}\small\item\em free XML document struct \item\end{CompactList}\item 
void {\bf xml\-Add\-Text} ({\bf xml\-Node\-Ptr} node, {\bf xml\-Text\-Node\-Ptr} text)
\begin{CompactList}\small\item\em add a text node to a element \item\end{CompactList}\item 
{\bf xml\-Node\-Ptr} {\bf xml\-New\-Node} (const char $\ast$name)
\begin{CompactList}\small\item\em create a new element node \item\end{CompactList}\item 
{\bf xml\-Text\-Node\-Ptr} {\bf xml\-New\-Text} (const char $\ast$text)
\begin{CompactList}\small\item\em create a new text node \item\end{CompactList}\item 
{\bf xml\-Node\-Ptr} {\bf xml\-Add\-Child} ({\bf xml\-Node\-Ptr} father, {\bf xml\-Node\-Ptr} child)
\begin{CompactList}\small\item\em add child node to the father node \item\end{CompactList}\item 
void {\bf xml\-Add\-Prop} ({\bf xml\-Node\-Ptr} node, const char $\ast$prop\-Name, const char $\ast$prop\-Value)
\begin{CompactList}\small\item\em add property to a node \item\end{CompactList}\item 
void {\bf printf\-Xml\-Doc} (FILE $\ast$f, {\bf xml\-Doc\-Ptr} doc)
\begin{CompactList}\small\item\em print document's XML to a file \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
Mini XML lib. 

(C) 2007 GEC. All rights reserved.

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


\subsection{Function Documentation}
\index{minixml.c@{minixml.c}!printfXmlDoc@{printfXmlDoc}}
\index{printfXmlDoc@{printfXmlDoc}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void printf\-Xml\-Doc (FILE $\ast$ {\em f}, {\bf xml\-Doc\-Ptr} {\em doc})}\label{minixml_8c_6c84070a9d11893975565b05c4b1ffd1}


print document's XML to a file 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em f}][in] file pointer \item[{\em doc}][in] doc pointer \end{description}
\end{Desc}
\index{minixml.c@{minixml.c}!xmlAddChild@{xmlAddChild}}
\index{xmlAddChild@{xmlAddChild}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf xml\-Node\-Ptr} xml\-Add\-Child ({\bf xml\-Node\-Ptr} {\em father}, {\bf xml\-Node\-Ptr} {\em child})}\label{minixml_8c_61210b05d003f772984e49bc1dfd16b4}


add child node to the father node 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em father}][in] father node \item[{\em child}][in] child node \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]child node \end{Desc}
\index{minixml.c@{minixml.c}!xmlAddProp@{xmlAddProp}}
\index{xmlAddProp@{xmlAddProp}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void xml\-Add\-Prop ({\bf xml\-Node\-Ptr} {\em node}, const char $\ast$ {\em prop\-Name}, const char $\ast$ {\em prop\-Value})}\label{minixml_8c_d6194b6aa2f53e2313a4610bf4f798db}


add property to a node 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em node}][in] file pointer \item[{\em prop\-Name}][in] name of the property \item[{\em prop\-Value}][in] value of the property \end{description}
\end{Desc}
\index{minixml.c@{minixml.c}!xmlAddText@{xmlAddText}}
\index{xmlAddText@{xmlAddText}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void xml\-Add\-Text ({\bf xml\-Node\-Ptr} {\em node}, {\bf xml\-Text\-Node\-Ptr} {\em text})}\label{minixml_8c_dd9e10eea08dd71f8b171d2d8ac0cabe}


add a text node to a element 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em node}][in] XML element node \item[{\em text}][in] text node \end{description}
\end{Desc}
\index{minixml.c@{minixml.c}!xmlFreeDoc@{xmlFreeDoc}}
\index{xmlFreeDoc@{xmlFreeDoc}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void xml\-Free\-Doc ({\bf xml\-Doc\-Ptr} {\em doc})}\label{minixml_8c_309c9851f4ca866f3136bedfe9ecb4bd}


free XML document struct 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em doc}][in] doc that want to destroy \end{description}
\end{Desc}
\index{minixml.c@{minixml.c}!xmlFreeNode@{xmlFreeNode}}
\index{xmlFreeNode@{xmlFreeNode}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void xml\-Free\-Node ({\bf xml\-Node\-Ptr} {\em node})}\label{minixml_8c_d9953555fb07de46d3015eeca188aee5}


free XML document struct 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em node}][in] XML node that want to destroy \end{description}
\end{Desc}
\index{minixml.c@{minixml.c}!xmlNewDoc@{xmlNewDoc}}
\index{xmlNewDoc@{xmlNewDoc}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf xml\-Doc\-Ptr} xml\-New\-Doc ()}\label{minixml_8c_69701ce3d0f8331132d197da5802b2ed}


\doxyref{xml\-Doc}{p.}{structxml_doc} struct pointer 

\begin{Desc}
\item[Returns:]new XML document pointer, you MUST release it by xml\-Free\-Doc \end{Desc}
\index{minixml.c@{minixml.c}!xmlNewNode@{xmlNewNode}}
\index{xmlNewNode@{xmlNewNode}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf xml\-Node\-Ptr} xml\-New\-Node (const char $\ast$ {\em name})}\label{minixml_8c_8251cf8c24635242ffce4d4e98149d8e}


create a new element node 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em name}][in] tag name of the new element node \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]new element node \end{Desc}
\index{minixml.c@{minixml.c}!xmlNewText@{xmlNewText}}
\index{xmlNewText@{xmlNewText}!minixml.c@{minixml.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf xml\-Text\-Node\-Ptr} xml\-New\-Text (const char $\ast$ {\em text})}\label{minixml_8c_8f8779f8481d2bc6840b10ee2bdd313a}


create a new text node 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em text}][in] valve of the text node \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]new text node \end{Desc}