src/vm/utf8.h

   1 /* src/vm/utf.h - utf string header
   2
   3    Copyright (C) 1996-2005 R. Grafl, A. Krall, C. Kruegel, C. Oates,
   4    R. Obermaisser, M. Platter, M. Probst, S. Ring, E. Steiner,
   5    C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich, J. Wenninger,
   6    Institut f. Computersprachen - TU Wien
   7
   8    This file is part of CACAO.
   9
  10    This program is free software; you can redistribute it and/or
  11    modify it under the terms of the GNU General Public License as
  12    published by the Free Software Foundation; either version 2, or (at
  13    your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful, but
  16    WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18    General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  23    02111-1307, USA.
  24
  25    Contact: cacao@complang.tuwien.ac.at
  26
  27    Authors: Christian Thalinger
  28
  29    Changes:
  30
  31    $Id: utf8.h 2322 2005-04-21 22:17:46Z twisti $
  32
  33 */
  34
  35
  36 #ifndef _UTF_H
  37 #define _UTF_H
  38
  39 #include <stdio.h>
  40
  41
  42 /* forward typedefs ***********************************************************/
  43
  44 typedef struct utf utf;
  45
  46
  47 #include "vm/global.h"
  48
  49
  50 /* data structure for utf8 symbols ********************************************/
  51
  52 struct utf {
  53         utf  *hashlink;                     /* link for external hash chain       */
  54         int   blength;                      /* text length in bytes               */
  55         char *text;                         /* pointer to text                    */
  56 };
  57
  58
  59 /* utf-symbols for pointer comparison of frequently used strings **************/
  60
  61 extern utf *utf_java_lang_Object;
  62
  63 extern utf *utf_java_lang_Class;
  64 extern utf *utf_java_lang_ClassLoader;
  65 extern utf *utf_java_lang_Cloneable;
  66 extern utf *utf_java_lang_SecurityManager;
  67 extern utf *utf_java_lang_String;
  68 extern utf *utf_java_lang_System;
  69 extern utf *utf_java_lang_ThreadGroup;
  70 extern utf *utf_java_io_Serializable;
  71
  72 extern utf *utf_java_lang_Throwable;
  73 extern utf *utf_java_lang_VMThrowable;
  74 extern utf *utf_java_lang_Error;
  75 extern utf *utf_java_lang_Exception;
  76 extern utf *utf_java_lang_NoClassDefFoundError;
  77 extern utf *utf_java_lang_OutOfMemoryError;
  78 extern utf *utf_java_lang_ClassNotFoundException;
  79
  80 extern utf* utf_java_lang_Void;
  81 extern utf* utf_java_lang_Boolean;
  82 extern utf* utf_java_lang_Byte;
  83 extern utf* utf_java_lang_Character;
  84 extern utf* utf_java_lang_Short;
  85 extern utf* utf_java_lang_Integer;
  86 extern utf* utf_java_lang_Long;
  87 extern utf* utf_java_lang_Float;
  88 extern utf* utf_java_lang_Double;
  89
  90 extern utf *utf_java_util_Vector;
  91
  92 extern utf *utf_InnerClasses;
  93 extern utf *utf_ConstantValue;
  94 extern utf *utf_Code;
  95 extern utf *utf_Exceptions;
  96 extern utf *utf_LineNumberTable;
  97 extern utf *utf_SourceFile;
  98
  99 extern utf *utf_init;
 100 extern utf *utf_clinit;
 101 extern utf *utf_finalize;
 102
 103 extern utf *utf_printStackTrace;
 104 extern utf *utf_fillInStackTrace;
 105 extern utf *utf_loadClass;
 106
 107 extern utf *utf_void__void;
 108 extern utf *utf_boolean__void;
 109 extern utf *utf_byte__void;
 110 extern utf *utf_char__void;
 111 extern utf *utf_short__void;
 112 extern utf *utf_int__void;
 113 extern utf *utf_long__void;
 114 extern utf *utf_float__void;
 115 extern utf *utf_double__void;
 116 extern utf *utf_void__java_lang_Object;
 117 extern utf *utf_void__java_lang_Throwable;
 118 extern utf *utf_java_lang_String__void;
 119 extern utf *utf_java_lang_String__java_lang_Class;
 120 extern utf *utf_java_lang_Throwable__void;
 121
 122 extern utf *utf_not_named_yet;
 123
 124 extern utf *array_packagename;
 125
 126
 127 /* function prototypes ********************************************************/
 128
 129 void utf8_init(void);
 130
 131 u4 utf_hashkey(const char *text, u4 length);
 132
 133 /* determine hashkey of a unicode-symbol */
 134 u4 unicode_hashkey(u2 *text, u2 length);
 135
 136 /* create new utf-symbol */
 137 utf *utf_new(const char *text, u2 length);
 138
 139 /* without locking (caller already holding lock*/
 140 utf *utf_new_intern(const char *text, u2 length);
 141
 142 /* make utf symbol from u2 array */
 143 utf *utf_new_u2(u2 *unicodedata, u4 unicodelength, bool isclassname);
 144
 145 utf *utf_new_char(const char *text);
 146 utf *utf_new_char_classname(const char *text);
 147
 148 /* get next unicode character of a utf-string */
 149 u2 utf_nextu2(char **utf);
 150
 151 /* get number of unicode characters of a utf string */
 152 u4 utf_strlen(utf *u);
 153
 154 /* determine utf length in bytes of a u2 array */
 155 u4 u2_utflength(u2 *text, u4 u2_length);
 156
 157 /* write utf symbol to file/buffer */
 158 void utf_display(utf *u);
 159 void utf_display_classname(utf *u);
 160
 161 void utf_sprint(char *buffer, utf *u);
 162 void utf_sprint_classname(char *buffer, utf *u);
 163
 164 void utf_strcat(char *buffer, utf *u);
 165 void utf_strcat_classname(char *buffer, utf *u);
 166
 167 void utf_fprint(FILE *file, utf *u);
 168 void utf_fprint_classname(FILE *file, utf *u);
 169
 170 /* check if a UTF-8 string is valid */
 171 bool is_valid_utf(char *utf_ptr, char *end_pos);
 172
 173 /* check if a UTF-8 string may be used as a class/field/method name */
 174 bool is_valid_name(char *utf_ptr, char *end_pos);
 175 bool is_valid_name_utf(utf *u);
 176
 177 /* show utf-table */
 178 void utf_show(void);
 179
 180 #endif /* _UTF_H */
 181
 182
 183 /*
 184  * These are local overrides for various environment variables in Emacs.
 185  * Please do not remove this and leave it at the end of the file, where
 186  * Emacs will automagically detect them.
 187  * ---------------------------------------------------------------------
 188  * Local variables:
 189  * mode: c
 190  * indent-tabs-mode: t
 191  * c-basic-offset: 4
 192  * tab-width: 4
 193  * End:
 194  */