version 1.1.2.1, 2005/10/08 02:01:46
|
version 1.10, 2008/12/01 17:49:56
|
|
|
//%2005//////////////////////////////////////////////////////////////////////// |
//%LICENSE//////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Licensed to The Open Group (TOG) under one or more contributor license |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
// this work for additional information regarding copyright ownership. |
// IBM Corp.; EMC Corporation, The Open Group. |
// Each contributor licenses this file to you under the OpenPegasus Open |
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
// Source License; you may not use this file except in compliance with the |
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// License. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// |
|
// Permission is hereby granted, free of charge, to any person obtaining a copy |
|
// of this software and associated documentation files (the "Software"), to |
|
// deal in the Software without restriction, including without limitation the |
|
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
|
// sell copies of the Software, and to permit persons to whom the Software is |
|
// furnished to do so, subject to the following conditions: |
|
// |
|
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
|
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
|
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
|
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
|
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
|
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
|
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// | // |
//============================================================================== |
// Permission is hereby granted, free of charge, to any person obtaining a |
|
// copy of this software and associated documentation files (the "Software"), |
|
// to deal in the Software without restriction, including without limitation |
|
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
|
// and/or sell copies of the Software, and to permit persons to whom the |
|
// Software is furnished to do so, subject to the following conditions: |
|
// |
|
// The above copyright notice and this permission notice shall be included |
|
// in all copies or substantial portions of the Software. |
|
// |
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
|
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
|
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
|
// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
|
// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
|
// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
|
// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// |
|
////////////////////////////////////////////////////////////////////////// |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#ifndef _Pegasus_StringRep_h | #ifndef _Pegasus_StringRep_h |
#define _Pegasus_StringRep_h | #define _Pegasus_StringRep_h |
| |
#include <Pegasus/Common/Atomic.h> |
#include <Pegasus/Common/Config.h> |
|
#include <Pegasus/Common/AtomicInt.h> |
|
#include <new> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
struct StringRep |
struct PEGASUS_COMMON_LINKAGE StringRep |
{ | { |
StringRep(); | StringRep(); |
| |
|
|
| |
static StringRep* create(const char* data, size_t size); | static StringRep* create(const char* data, size_t size); |
| |
static StringRep* createASCII7(const char* data, size_t size); |
static StringRep* copyOnWrite(StringRep* rep); |
|
|
static StringRep* copy_on_write(StringRep* rep); |
|
| |
static Uint32 length(const Uint16* str); | static Uint32 length(const Uint16* str); |
| |
|
|
| |
static void unref(const StringRep* rep); | static void unref(const StringRep* rep); |
| |
static StringRep _empty_rep; |
static StringRep _emptyRep; |
| |
|
// Number of characters in this string, excluding the null terminator. |
size_t size; | size_t size; |
|
|
|
// Number of characters this representation has room for. This is |
|
// greater or equal to size. |
size_t cap; | size_t cap; |
Atomic refs; |
|
|
// Number of string refering to this StringRep (1, 2, etc). |
|
AtomicInt refs; |
|
|
|
// The first character in the string. Extra space is allocated off the |
|
// end of this structure for additional characters. |
Uint16 data[1]; | Uint16 data[1]; |
}; | }; |
| |
inline void StringRep::free(StringRep* rep) | inline void StringRep::free(StringRep* rep) |
{ | { |
Atomic_destroy(&rep->refs); |
rep->refs.~AtomicInt(); |
::operator delete(rep); | ::operator delete(rep); |
} | } |
| |
inline StringRep::StringRep() : size(0), cap(0) |
inline StringRep::StringRep() : size(0), cap(0), refs(2) |
{ | { |
// Only called on _empty_rep. |
// Only called on _emptyRep. We set the reference count to two to |
Atomic_create(&refs, 99); |
// keep a String from modifying it (if the reference count were one, |
|
// a string would think it was the sole owner of the StringRep object). |
data[0] = 0; | data[0] = 0; |
} | } |
| |
inline StringRep::~StringRep() | inline StringRep::~StringRep() |
{ | { |
// Only called on _empty_rep. |
// Only called on _emptyRep. |
Atomic_destroy(&refs); |
|
} | } |
| |
inline void StringRep::ref(const StringRep* rep) | inline void StringRep::ref(const StringRep* rep) |
{ | { |
if (rep != &StringRep::_empty_rep) |
if (rep != &StringRep::_emptyRep) |
Atomic_inc(&((StringRep*)rep)->refs); |
((StringRep*)rep)->refs++; |
} | } |
| |
inline void StringRep::unref(const StringRep* rep) | inline void StringRep::unref(const StringRep* rep) |
{ | { |
if (rep != &StringRep::_empty_rep && |
if (rep != &StringRep::_emptyRep && |
Atomic_dec_and_test(&((StringRep*)rep)->refs)) |
((StringRep*)rep)->refs.decAndTestIfZero()) |
StringRep::free((StringRep*)rep); | StringRep::free((StringRep*)rep); |
} | } |
| |
PEGASUS_COMMON_LINKAGE void String_throw_out_of_bounds(); |
PEGASUS_COMMON_LINKAGE void StringThrowOutOfBounds(); |
|
|
|
PEGASUS_COMMON_LINKAGE void StringAppendCharAux(StringRep*& _rep); |
|
|
|
PEGASUS_COMMON_LINKAGE Boolean StringEqualNoCase( |
|
const String& s1, const String& s2); |
|
|
|
PEGASUS_COMMON_LINKAGE Uint32 StringFindAux( |
|
const StringRep* _rep, const Char16* s, Uint32 n); |
| |
#ifdef PEGASUS_STRING_NO_THROW |
inline void _checkBounds(size_t index, size_t size) |
# define _check_bounds(ARG1, ARG2) /* empty */ |
|
#else |
|
inline void _check_bounds(size_t index, size_t size) |
|
{ | { |
if (index > size) | if (index > size) |
String_throw_out_of_bounds(); |
StringThrowOutOfBounds(); |
} | } |
#endif |
|
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |
| |