1 /* src/vm/utf8.h - utf8 string functions
3 Copyright (C) 1996-2005, 2006 R. Grafl, A. Krall, C. Kruegel,
4 C. Oates, R. Obermaisser, M. Platter, M. Probst, S. Ring,
5 E. Steiner, C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich,
6 J. Wenninger, Institut f. Computersprachen - TU Wien
8 This file is part of CACAO.
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.
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.
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., 51 Franklin Street, Fifth Floor, Boston, MA
25 Contact: cacao@cacaojvm.org
27 Authors: Christian Thalinger
29 Changes: Edwin Steiner
31 $Id: utf8.h 4882 2006-05-05 18:49:01Z edwin $
42 /* forward typedefs ***********************************************************/
44 typedef struct utf utf;
49 #include "vm/global.h"
52 /* data structure for utf8 symbols ********************************************/
55 utf *hashlink; /* link for external hash chain */
56 s4 blength; /* text length in bytes */
57 char *text; /* pointer to text */
60 /* to determine the end of utf strings */
62 #define UTF_END(u) ((char *) u->text + u->blength)
65 /* utf-symbols for pointer comparison of frequently used strings **************/
67 extern utf *utf_java_lang_Object;
69 extern utf *utf_java_lang_Class;
70 extern utf *utf_java_lang_ClassLoader;
71 extern utf *utf_java_lang_Cloneable;
72 extern utf *utf_java_lang_SecurityManager;
73 extern utf *utf_java_lang_String;
74 extern utf *utf_java_lang_System;
75 extern utf *utf_java_lang_ThreadGroup;
76 extern utf *utf_java_io_Serializable;
78 extern utf *utf_java_lang_Throwable;
79 extern utf *utf_java_lang_VMThrowable;
80 extern utf *utf_java_lang_Error;
81 extern utf *utf_java_lang_NoClassDefFoundError;
82 extern utf *utf_java_lang_LinkageError;
83 extern utf *utf_java_lang_NoSuchMethodError;
84 extern utf *utf_java_lang_OutOfMemoryError;
86 extern utf *utf_java_lang_Exception;
87 extern utf *utf_java_lang_ClassNotFoundException;
88 extern utf *utf_java_lang_IllegalArgumentException;
89 extern utf *utf_java_lang_IllegalMonitorStateException;
91 extern utf *utf_java_lang_NullPointerException;
93 extern utf* utf_java_lang_Void;
94 extern utf* utf_java_lang_Boolean;
95 extern utf* utf_java_lang_Byte;
96 extern utf* utf_java_lang_Character;
97 extern utf* utf_java_lang_Short;
98 extern utf* utf_java_lang_Integer;
99 extern utf* utf_java_lang_Long;
100 extern utf* utf_java_lang_Float;
101 extern utf* utf_java_lang_Double;
103 extern utf *utf_java_lang_StackTraceElement;
104 extern utf *utf_java_lang_reflect_Constructor;
105 extern utf *utf_java_lang_reflect_Field;
106 extern utf *utf_java_lang_reflect_Method;
107 extern utf *utf_java_util_Vector;
110 extern utf *utf_InnerClasses;
111 extern utf *utf_ConstantValue;
112 extern utf *utf_Code;
113 extern utf *utf_Exceptions;
114 extern utf *utf_LineNumberTable;
115 extern utf *utf_SourceFile;
117 extern utf *utf_init;
118 extern utf *utf_clinit;
119 extern utf *utf_clone;
120 extern utf *utf_finalize;
124 extern utf *utf_remove;
127 extern utf *utf_value;
129 extern utf *utf_fillInStackTrace;
130 extern utf *utf_getSystemClassLoader;
131 extern utf *utf_loadClass;
132 extern utf *utf_printStackTrace;
143 extern utf *utf_void__void;
144 extern utf *utf_boolean__void;
145 extern utf *utf_byte__void;
146 extern utf *utf_char__void;
147 extern utf *utf_short__void;
148 extern utf *utf_int__void;
149 extern utf *utf_long__void;
150 extern utf *utf_float__void;
151 extern utf *utf_double__void;
153 extern utf *utf_void__java_lang_ClassLoader;
154 extern utf *utf_void__java_lang_Object;
155 extern utf *utf_void__java_lang_Throwable;
156 extern utf *utf_java_lang_Object__java_lang_Object;
157 extern utf *utf_java_lang_String__void;
158 extern utf *utf_java_lang_String__java_lang_Class;
159 extern utf *utf_java_lang_Throwable__void;
161 extern utf *utf_not_named_yet;
163 extern utf *array_packagename;
166 /* function prototypes ********************************************************/
168 /* initialize the utf8 subsystem */
169 bool utf8_init(void);
171 u4 utf_hashkey(const char *text, u4 length);
172 u4 utf_full_hashkey(const char *text, u4 length);
174 /* determine hashkey of a unicode-symbol */
175 u4 unicode_hashkey(u2 *text, u2 length);
177 /* create new utf-symbol */
178 utf *utf_new(const char *text, u2 length);
180 /* make utf symbol from u2 array */
181 utf *utf_new_u2(u2 *unicodedata, u4 unicodelength, bool isclassname);
183 utf *utf_new_char(const char *text);
184 utf *utf_new_char_classname(const char *text);
186 /* get number of bytes */
187 u4 utf_bytes(utf *u);
189 /* get next unicode character of a utf-string */
190 u2 utf_nextu2(char **utf);
192 /* get number of unicode characters of a utf string */
193 u4 utf_get_number_of_u2s(utf *u);
194 u4 utf_get_number_of_u2s_for_buffer(const char *buffer, u4 blength);
196 /* determine utf length in bytes of a u2 array */
197 u4 u2_utflength(u2 *text, u4 u2_length);
199 void utf_copy(char *buffer, utf *u);
200 void utf_cat(char *buffer, utf *u);
201 void utf_copy_classname(char *buffer, utf *u);
202 void utf_cat_classname(char *buffer, utf *u);
204 /* write utf symbol to file/buffer */
205 void utf_display_printable_ascii(utf *u);
206 void utf_display_printable_ascii_classname(utf *u);
208 void utf_sprint_convert_to_latin1(char *buffer, utf *u);
209 void utf_sprint_convert_to_latin1_classname(char *buffer, utf *u);
211 void utf_strcat_convert_to_latin1(char *buffer, utf *u);
212 void utf_strcat_convert_to_latin1_classname(char *buffer, utf *u);
214 void utf_fprint_printable_ascii(FILE *file, utf *u);
215 void utf_fprint_printable_ascii_classname(FILE *file, utf *u);
217 /* check if a UTF-8 string is valid */
218 bool is_valid_utf(char *utf_ptr, char *end_pos);
220 /* check if a UTF-8 string may be used as a class/field/method name */
221 bool is_valid_name(char *utf_ptr, char *end_pos);
222 bool is_valid_name_utf(utf *u);
231 * These are local overrides for various environment variables in Emacs.
232 * Please do not remove this and leave it at the end of the file, where
233 * Emacs will automagically detect them.
234 * ---------------------------------------------------------------------
237 * indent-tabs-mode: t
241 * vim:noexpandtab:sw=4:ts=4: