home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2307 / StrTable.h < prev    next >
Encoding:
C/C++ Source or Header  |  1990-12-28  |  2.7 KB  |  64 lines
  1. /*
  2.  * Author: Jason Baietto, jason@ssd.csd.harris.com
  3.  * xdiary Copyright 1990 Harris Corporation
  4.  *
  5.  * Permission to use, copy, modify, and distribute, this software and its
  6.  * documentation for any purpose is hereby granted without fee, provided that
  7.  * the above copyright notice appear in all copies and that both that
  8.  * copyright notice and this permission notice appear in supporting
  9.  * documentation, and that the name of the copyright holder be used in
  10.  * advertising or publicity pertaining to distribution of the software with
  11.  * specific, written prior permission, and that no fee is charged for further
  12.  * distribution of this software, or any modifications thereof.  The copyright
  13.  * holder makes no representations about the suitability of this software for
  14.  * any purpose.  It is provided "as is" without express or implied warranty.
  15.  *
  16.  * THE COPYRIGHT HOLDER DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  17.  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, AND IN NO
  18.  * EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  19.  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM ITS USE,
  20.  * LOSS OF DATA, PROFITS, QPA OR GPA, WHETHER IN AN ACTION OF CONTRACT,
  21.  * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH
  22.  * THE USE OR PERFORMANCE OF THIS SOFTWARE.
  23.  */
  24.  
  25. #ifndef _StringTableConverter_h
  26. #define _StringTableConverter_h
  27. /* 
  28.    StringTableConverter --  Convert a comma separated list of quote
  29.                             enclosed strings into a StringTable resource.
  30.  
  31.    example:  xdiary*dayNames: "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
  32.  
  33.    A StringTable is an array of pointers to strings whose last entry is NULL.
  34.    If no strings are specified, the initial entry is NULL.  Double quotes 
  35.    delimit the string, but two consecutive quotes become a single double
  36.    quote in the final string.  For example, """Wow!""" becomes "Wow!".
  37.  
  38.    int StringTableNumber(StringTable) -- Returns the number of strings in
  39.                                          a specified string table.
  40.  
  41.    void StringTableDump(StringTable) -- Dumps the contents of a string table.
  42.                                         Useful for debugging purposes only.
  43.  
  44.    StringTable StringTableCopy(StringTable) -- Allocates a new array, but uses
  45.                                                the same string pointers.
  46.                                                Be careful with this one.
  47.  
  48.    Author: Jason Baietto
  49.    Date:   9/20/90
  50. */
  51.  
  52. typedef char ** StringTable;
  53.  
  54. extern void StringTableConverter();
  55. extern int StringTableNumber();
  56. extern void StringTableDump();
  57. extern StringTable StringTableCopy();
  58.  
  59. #ifndef XtRStringTable
  60. #define XtRStringTable "StringTable"
  61. #endif
  62.  
  63. #endif /* _StringTableConverter_h */
  64.