src/vm/stringlocal.h

   1 /* src/vm/stringlocal.h - string header
   2
   3    Copyright (C) 1996-2005, 2006, 2007 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
   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., 51 Franklin Street, Fifth Floor, Boston, MA
  23    02110-1301, USA.
  24
  25 */
  26
  27
  28 #ifndef _STRINGLOCAL_H
  29 #define _STRINGLOCAL_H
  30
  31 typedef struct literalstring literalstring;
  32
  33
  34 #include "config.h"
  35 #include "vm/types.h"
  36
  37 #include "toolbox/hashtable.h"
  38
  39 #include "vm/global.h"
  40
  41 #include "vmcore/utf8.h"
  42
  43
  44 /* data structure of internal javastrings stored in global hashtable **********/
  45
  46 struct literalstring {
  47         literalstring     *hashlink;        /* link for external hash chain       */
  48         java_object_t     *string;
  49 };
  50
  51
  52 /* javastring-hashtable */
  53 extern hashtable hashtable_string;
  54
  55
  56 /* function prototypes ********************************************************/
  57
  58 /* initialize string subsystem */
  59 bool string_init(void);
  60
  61 void stringtable_update(void);
  62
  63 /* creates a new object of type java/lang/String from a utf-text */
  64 java_handle_t *javastring_new(utf *text);
  65
  66 /* creates a new object of type java/lang/String from a utf-text, changes slashes to dots */
  67 java_handle_t *javastring_new_slash_to_dot(utf *text);
  68
  69 /* creates a new object of type java/lang/String from an ASCII c-string */
  70 java_handle_t *javastring_new_from_ascii(const char *text);
  71
  72 /* creates a new object of type java/lang/String from UTF-8 */
  73 java_handle_t *javastring_new_from_utf_string(const char *utfstr);
  74
  75 /* creates a new object of type java/lang/String from (possibly invalid) UTF-8 */
  76 java_handle_t *javastring_safe_new_from_utf8(const char *text);
  77
  78 /* make c-string from a javastring (debugging) */
  79 char *javastring_tochar(java_handle_t *string);
  80
  81 /* make utf symbol from javastring */
  82 utf *javastring_toutf(java_handle_t *string, bool isclassname);
  83
  84 /* creates a new javastring with the text of the u2-array */
  85 java_object_t *literalstring_u2(java_chararray_t *a, u4 length, u4 offset,
  86                                                                 bool copymode);
  87
  88 /* creates a new javastring with the text of the utf-symbol */
  89 java_object_t *literalstring_new(utf *u);
  90
  91 /* dispose a javastring */
  92 void literalstring_free(java_object_t*);
  93
  94 java_handle_t *javastring_intern(java_handle_t *s);
  95 void           javastring_print(java_handle_t *s);
  96
  97 #endif /* _STRINGLOCAL_H */
  98
  99
 100 /*
 101  * These are local overrides for various environment variables in Emacs.
 102  * Please do not remove this and leave it at the end of the file, where
 103  * Emacs will automagically detect them.
 104  * ---------------------------------------------------------------------
 105  * Local variables:
 106  * mode: c
 107  * indent-tabs-mode: t
 108  * c-basic-offset: 4
 109  * tab-width: 4
 110  * End:
 111  * vim:noexpandtab:sw=4:ts=4:
 112  */