<!DOCTYPE LINUXDOC SYSTEM>

<!-- This SGML file generated by cxref. -->
<!-- cxref program (c) Andrew M. Bishop 1995,96,97,98. -->

<article>

<title>Cross reference for slist.c of cxref.
<author>cxref

<sect>File slist.c
<bf>RCS Header: /home/amb/cxref/RCS/slist.c 1.3 1997/05/11 15:23:11 amb Exp </bf>
<p>

  C Cross Referencing &amp; Documentation tool. Version 1.4.
<newline>
  Handle lists of strings.
<p>

<sect1>Included Files

<p>
<itemize>
<item><tt>#include &lt;stdlib.h&gt;</tt>
</itemize>
<itemize>
<item><tt>#include &lt;stdio.h&gt;</tt>
</itemize>
<itemize>
<item><tt>#include &lt;string.h&gt;</tt>
</itemize>
<itemize>
<item><tt>#include &quot;memory.h&quot;</tt>
</itemize>
<itemize>
<item><tt>#include &quot;datatype.h&quot;</tt>
</itemize>
<itemize>
<item><tt>#include &quot;cxref.h&quot;</tt>
<itemize>
<item><tt>#include &quot;datatype.h&quot;</tt>
</itemize>
</itemize>

<sect1>Preprocessor definitions

<p>
 Control the debugging information from this file. 
<p>
<tt>#define DEBUG 0</tt><newline>

<sect1>Global Function AddToStringList()

<p>  Add a string to the string list, the list stores a Malloced copy of str.
<p>
<tt>void AddToStringList ( StringList sl, char* str, int alphalist, int uniqlist )</tt><newline>
<descrip>
<tag><tt>StringList sl</tt></tag>
The string list to add to.
<tag><tt>char* str</tt></tag>
The string to add.
<tag><tt>int alphalist</tt></tag>
If true then the list is sorted into alphabetical order.
<tag><tt>int uniqlist</tt></tag>
If true then duplicated entries are not allowed to be added.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeMalloc()  :  memory.c
<item>SafeMallocString()  :  memory.c
<item>SafeRealloc()  :  memory.c
<item>strcmp()
</itemize>
<tag>Called by:</tag>
<itemize>
<item>CreateAppendix()  :  xref.c
<item>CrossReference()  :  xref.c
<item>SeenFunctionProto()  :  func.c
</itemize>
</descrip>

<sect1>Global Function AddToStringList2()

<p>  Add a pair of strings to the string list 2, the list stores a Malloced copy of the arguments.
<p>
<tt>void AddToStringList2 ( StringList2 sl, char* str1, char* str2, int alphalist, int uniqlist )</tt><newline>
<descrip>
<tag><tt>StringList2 sl</tt></tag>
The string list 2 to add to.
<tag><tt>char* str1</tt></tag>
The first string to add.
<tag><tt>char* str2</tt></tag>
The second string to add.
<tag><tt>int alphalist</tt></tag>
If true then the list is sorted into alphabetical order of the first string, then second string.
<tag><tt>int uniqlist</tt></tag>
If true then duplicated entries of the first string are not allowed to be added.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeMalloc()  :  memory.c
<item>SafeMallocString()  :  memory.c
<item>SafeRealloc()  :  memory.c
<item>strcmp()
</itemize>
<tag>Called by:</tag>
<itemize>
<item>CheckFunctionVariableRef()  :  func.c
<item>CreateAppendix()  :  xref.c
<item>SeenDefineFunctionArg()  :  preproc.c
<item>SeenFunctionArg()  :  func.c
<item>SeenFunctionCall()  :  func.c
<item>SeenFunctionProto()  :  func.c
<item>SeenScopeVariable()  :  var.c
<item>SeenTypedefName()  :  type.c
<item>check_for_called()  :  xref.c
<item>check_for_var()  :  xref.c
<item>check_for_var_func()  :  xref.c
</itemize>
</descrip>

<sect1>Global Function DeleteStringList()

<p>  Delete a string list.
<p>
<tt>void DeleteStringList ( StringList sl )</tt><newline>
<descrip>
<tag><tt>StringList sl</tt></tag>
The string list to delete.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeFree()  :  memory.c
</itemize>
<tag>Called by:</tag>
<itemize>
<item>DeleteFile()  :  file.c
<item>DeleteFunctionType()  :  func.c
<item>main()  :  cxref.c
</itemize>
</descrip>

<sect1>Global Function DeleteStringList2()

<p>  Delete a string list 2.
<p>
<tt>void DeleteStringList2 ( StringList2 sl )</tt><newline>
<descrip>
<tag><tt>StringList2 sl</tt></tag>
The string list 2 to delete.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeFree()  :  memory.c
</itemize>
<tag>Called by:</tag>
<itemize>
<item>DeleteDefineType()  :  preproc.c
<item>DeleteFile()  :  file.c
<item>DeleteFunctionType()  :  func.c
<item>DeleteVariableType()  :  var.c
<item>DownScope()  :  var.c
<item>ResetFunctionAnalyser()  :  func.c
<item>ResetTypeAnalyser()  :  type.c
<item>ResetVariableAnalyser()  :  var.c
<item>main()  :  cxref.c
</itemize>
</descrip>

<sect1>Global Function NewStringList()

<p>  Called to initialise a new string list.
<p>
<tt>StringList NewStringList ( void )</tt><newline>
<descrip>
<tag><tt>StringList NewStringList</tt></tag>
Returns an initialised string list.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeCalloc()  :  memory.c
</itemize>
<tag>Called by:</tag>
<itemize>
<item>NewFile()  :  file.c
<item>NewFunctionType()  :  func.c
<item>main()  :  cxref.c
</itemize>
</descrip>

<sect1>Global Function NewStringList2()

<p>  Called to initialise a new string list 2.
<p>
<tt>StringList2 NewStringList2 ( void )</tt><newline>
<descrip>
<tag><tt>StringList2 NewStringList2</tt></tag>
Returns an initialised string list 2.
</descrip>
<descrip>
<tag>Prototyped in:</tag>
<itemize>
<item>cxref.h
</itemize>
<tag>Calls:</tag>
<itemize>
<item>SafeCalloc()  :  memory.c
</itemize>
<tag>Called by:</tag>
<itemize>
<item>NewDefineType()  :  preproc.c
<item>NewFile()  :  file.c
<item>NewFunctionType()  :  func.c
<item>NewVariableType()  :  var.c
<item>SeenFunctionProto()  :  func.c
<item>SeenTypedefName()  :  type.c
<item>UpScope()  :  var.c
<item>main()  :  cxref.c
</itemize>
</descrip>

</article>
