IT_Bus::String Class Reference

#include <it_bus/string.h>

List of all members.

---

Detailed Description

The String class represents the public interface of the Bus internationalized string.

It has roughly the same interface as the ISO/ANSI C++ std::basic_string class.

Definition at line 21 of file string.h.

Public Types
typedef IT_UShort	UChar
	Represents a utf16 code point.
Public Member Functions
	String (const char *str, IT_StringRep::Policy policy, size_t n=npos, const char *encoding=0, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	IONA-specific constructor to allow an String to refer to an existing char[] without copying it.
	String (const UChar *uchars, IT_StringRep::Policy policy, size_t n=npos, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Constructor from utf16 characters.
	String (const UChar *sb, const IT_String &encoding, size_t n=npos, IT_StringRep::Policy policy=IT_StringRep::COPY, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Deprecated.
	String (const wchar_t *wb, size_t n=npos, IT_StringRep::Policy policy=IT_StringRep::COPY, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Constructor from wchar_t*.
String &	insert (size_t pos, const UChar *uchars, size_t n=npos, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Insert utf16 characters.
String &	append (const UChar *uchars, size_t n=npos, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Append utf16 characters.
String &	replace (size_t pos, size_t n, const UChar *uchars, size_t n2=npos, IT_ExceptionHandler &eh=IT_EXCEPTION_HANDLER)
	Replace with utf16 string.

---

Constructor & Destructor Documentation

IT_Bus::String::String (  const char *  str, IT_StringRep::Policy  policy, size_t  n = npos, const char *  encoding = 0, IT_ExceptionHandler &  eh = IT_EXCEPTION_HANDLER )

IONA-specific constructor to allow an String to refer to an existing char[] without copying it. This is not a C++ standard string constructor.

IT_Bus::String::String (  const UChar *  uchars, IT_StringRep::Policy  policy, size_t  n = npos, IT_ExceptionHandler &  eh = IT_EXCEPTION_HANDLER )

Constructor from utf16 characters. Parameters: uchars  utf16 character array. policy  COPY to copy uchars, REFER to n  Number of utf16 characters. If unspecified assume uchars is null terminated point to uchars without copying.

---

Member Function Documentation

String& IT_Bus::String::append (  const UChar *  uchars, size_t  n = npos, IT_ExceptionHandler &  eh = IT_EXCEPTION_HANDLER )

Append utf16 characters. Parameters: uchars  utf16 characters to insert. n  Number of utf16 characters. If unspecified assume uchars is null terminated.

String& IT_Bus::String::insert (  size_t  pos, const UChar *  uchars, size_t  n = npos, IT_ExceptionHandler &  eh = IT_EXCEPTION_HANDLER )

Insert utf16 characters. Parameters: pos  Position to insert. uchars  utf16 characters to insert. n  Number of utf16 characters. If unspecified assume uchars is null terminated.

String& IT_Bus::String::replace (  size_t  pos, size_t  n, const UChar *  uchars, size_t  n2 = npos, IT_ExceptionHandler &  eh = IT_EXCEPTION_HANDLER )

Replace with utf16 string. Parameters: pos  Position of text to replace. n  Length of text to replace. uchars  utf16 string. n  Length of uchars, npos means uchars is null terminated.

---