git.sur5r.net Git - cc65/blob - src/cc65/litpool.h

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                 litpool.h                                 */
   4 /*                                                                           */
   5 /*              Literal string handling for the cc65 C compiler              */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 1998-2001 Ullrich von Bassewitz                                       */
  10 /*               Wacholderweg 14                                             */
  11 /*               D-70597 Stuttgart                                           */
  12 /* EMail:        uz@cc65.org                                                 */
  13 /*                                                                           */
  14 /*                                                                           */
  15 /* This software is provided 'as-is', without any expressed or implied       */
  16 /* warranty.  In no event will the authors be held liable for any damages    */
  17 /* arising from the use of this software.                                    */
  18 /*                                                                           */
  19 /* Permission is granted to anyone to use this software for any purpose,     */
  20 /* including commercial applications, and to alter it and redistribute it    */
  21 /* freely, subject to the following restrictions:                            */
  22 /*                                                                           */
  23 /* 1. The origin of this software must not be misrepresented; you must not   */
  24 /*    claim that you wrote the original software. If you use this software   */
  25 /*    in a product, an acknowledgment in the product documentation would be  */
  26 /*    appreciated but is not required.                                       */
  27 /* 2. Altered source versions must be plainly marked as such, and must not   */
  28 /*    be misrepresented as being the original software.                      */
  29 /* 3. This notice may not be removed or altered from any source              */
  30 /*    distribution.                                                          */
  31 /*                                                                           */
  32 /*****************************************************************************/
  33
  34
  35
  36 #ifndef LITPOOL_H
  37 #define LITPOOL_H
  38
  39
  40
  41 #include <stdio.h>
  42
  43 /* common */
  44 #include "strbuf.h"
  45
  46
  47
  48 /*****************************************************************************/
  49 /*                                   Data                                    */
  50 /*****************************************************************************/
  51
  52
  53
  54 extern unsigned LiteralPoolLabel;               /* Pool asm label */
  55
  56
  57
  58 /*****************************************************************************/
  59 /*                                   Code                                    */
  60 /*****************************************************************************/
  61
  62
  63
  64 void InitLiteralPool (void);
  65 /* Initialize the literal pool */
  66
  67 void TranslateLiteralPool (unsigned Offs);
  68 /* Translate the literals starting from the given offset into the target
  69  * charset.
  70  */
  71
  72 void DumpLiteralPool (void);
  73 /* Dump the literal pool */
  74
  75 unsigned GetLiteralPoolOffs (void);
  76 /* Return the current offset into the literal pool */
  77
  78 void ResetLiteralPoolOffs (unsigned Offs);
  79 /* Reset the offset into the literal pool to some earlier value, effectively
  80  * removing values from the pool.
  81  */
  82
  83 void AddLiteralChar (char C);
  84 /* Add one character to the literal pool */
  85
  86 unsigned AddLiteral (const char* S);
  87 /* Add a literal string to the literal pool. Return the starting offset into
  88  * the pool for this string.
  89  */
  90
  91 const char* GetLiteral (unsigned Offs);
  92 /* Get a pointer to the literal with the given offset in the pool */
  93
  94 void GetLiteralStrBuf (StrBuf* Target, unsigned Offs);
  95 /* Copy the string starting at Offs and lasting to the end of the buffer
  96  * into Target.
  97  */
  98
  99 void PrintLiteralPoolStats (FILE* F);
 100 /* Print statistics about the literal space used */
 101
 102
 103
 104 /* End of litpool.h */
 105 #endif
 106
 107
 108
 109