src/share/vm/utilities/utf8.hpp

Thu, 20 Nov 2008 16:56:09 -0800

author
ysr
date
Thu, 20 Nov 2008 16:56:09 -0800
changeset 888
c96030fff130
parent 435
a61af66fc99e
child 1907
c18cbe5936b8
permissions
-rw-r--r--

6684579: SoftReference processing can be made more efficient
Summary: For current soft-ref clearing policies, we can decide at marking time if a soft-reference will definitely not be cleared, postponing the decision of whether it will definitely be cleared to the final reference processing phase. This can be especially beneficial in the case of concurrent collectors where the marking is usually concurrent but reference processing is usually not.
Reviewed-by: jmasa

     1 /*
     2  * Copyright 1997-2003 Sun Microsystems, Inc.  All Rights Reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.
     8  *
     9  * This code is distributed in the hope that it will be useful, but WITHOUT
    10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    12  * version 2 for more details (a copy is included in the LICENSE file that
    13  * accompanied this code).
    14  *
    15  * You should have received a copy of the GNU General Public License version
    16  * 2 along with this work; if not, write to the Free Software Foundation,
    17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    18  *
    19  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    20  * CA 95054 USA or visit www.sun.com if you need additional information or
    21  * have any questions.
    22  *
    23  */
    25 // Low-level interface for UTF8 strings
    27 class UTF8 : AllStatic {
    28  public:
    29   // returns the unicode length of a 0-terminated uft8 string
    30   static int unicode_length(const char* uft8_str);
    32   // returns the unicode length of a non-0-terminated uft8 string
    33   static int unicode_length(const char* uft8_str, int len);
    35   // converts a uft8 string to a unicode string
    36   static void convert_to_unicode(const char* utf8_str, jchar* unicode_buffer, int unicode_length);
    38   // decodes the current utf8 character, stores the result in value,
    39   // and returns the end of the current uft8 chararacter.
    40   static char* next(const char* str, jchar* value);
    42   // decodes the current utf8 character, gets the supplementary character instead of
    43   // the surrogate pair when seeing a supplementary character in string,
    44   // stores the result in value, and returns the end of the current uft8 chararacter.
    45   static char* next_character(const char* str, jint* value);
    47   // Utility methods
    48   static jbyte* strrchr(jbyte* base, int length, jbyte c);
    49   static bool   equal(jbyte* base1, int length1, jbyte* base2, int length2);
    50   static bool   is_supplementary_character(const unsigned char* str);
    51   static jint   get_supplementary_character(const unsigned char* str);
    52 };
    55 // Low-level interface for UNICODE strings
    57 // A unicode string represents a string in the UTF-16 format in which supplementary
    58 // characters are represented by surrogate pairs. Index values refer to char code
    59 // units, so a supplementary character uses two positions in a unicode string.
    61 class UNICODE : AllStatic {
    62  public:
    63   // returns the utf8 size of a unicode character
    64   static int utf8_size(jchar c);
    66   // returns the utf8 length of a unicode string
    67   static int utf8_length(jchar* base, int length);
    69   // converts a unicode string to utf8 string
    70   static void convert_to_utf8(const jchar* base, int length, char* utf8_buffer);
    72   // converts a unicode string to a utf8 string; result is allocated
    73   // in resource area unless a buffer is provided.
    74   static char* as_utf8(jchar* base, int length);
    75   static char* as_utf8(jchar* base, int length, char* buf, int buflen);
    76 };

mercurial