• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • kjs
 

kjs

  • KJS
  • UString
Public Member Functions | Static Public Member Functions | Static Public Attributes | Friends | List of all members
KJS::UString Class Reference

#include <ustring.h>

Public Member Functions

 UString ()
 
 UString (char c)
 
 UString (const char *c)
 
 UString (const UChar *c, int length)
 
 UString (UChar *c, int length, bool copy)
 
 UString (const UString &s)
 
 UString (const TQString &)
 
 UString (const DOM::DOMString &)
 
 UString (const UString &, const UString &)
 
 ~UString ()
 
UString & append (const UString &)
 
CString cstring () const
 
char * ascii () const
 
DOM::DOMString string () const
 
TQString qstring () const
 
TQConstString qconststring () const
 
UString & operator= (const char *c)
 
UString & operator= (const UString &)
 
UString & operator+= (const UString &s)
 
const UChar * data () const
 
bool isNull () const
 
bool isEmpty () const
 
bool is8Bit () const
 
int size () const
 
UChar operator[] (int pos) const
 
UCharReference operator[] (int pos)
 
double toDouble (bool tolerateTrailingJunk, bool tolerateEmptyString) const
 
double toDouble (bool tolerateTrailingJunk) const
 
double toDouble () const
 
unsigned long toULong (bool *ok, bool tolerateEmptyString) const
 
unsigned long toULong (bool *ok=0) const
 
unsigned int toUInt32 (bool *ok=0) const
 
unsigned int toStrictUInt32 (bool *ok=0) const
 
unsigned toArrayIndex (bool *ok=0) const
 
UString toLower () const
 
UString toUpper () const
 
int find (const UString &f, int pos=0) const
 
int find (UChar, int pos=0) const
 
int rfind (const UString &f, int pos) const
 
int rfind (UChar, int pos) const
 
UString substr (int pos=0, int len=-1) const
 

Static Public Member Functions

static UString from (int i)
 
static UString from (unsigned int u)
 
static UString from (long l)
 
static UString from (double d)
 

Static Public Attributes

static UString null
 

Friends

class UCharReference
 
class Identifier
 
class PropertyMap
 
class PropertyMapHashTableEntry
 
bool operator== (const UString &, const UString &)
 

Detailed Description

Unicode string class.

Definition at line 190 of file ustring.h.

Constructor & Destructor Documentation

◆ UString() [1/9]

UString::UString ( )

Constructs a null string.

Definition at line 270 of file ustring.cpp.

◆ UString() [2/9]

UString::UString ( char  c)
explicit

Constructs a string from the single character c.

Definition at line 276 of file ustring.cpp.

◆ UString() [3/9]

UString::UString ( const char *  c)

Constructs a string from a classical zero determined char string.

Definition at line 283 of file ustring.cpp.

◆ UString() [4/9]

UString::UString ( const UChar *  c,
int  length 
)

Constructs a string from an array of Unicode characters of the specified length.

Definition at line 300 of file ustring.cpp.

◆ UString() [5/9]

UString::UString ( UChar *  c,
int  length,
bool  copy 
)

If copy is false the string data will be adopted.

That means that the data will NOT be copied and the pointer will be deleted when the UString object is modified or destroyed. Behaviour defaults to a deep copy if copy is true.

Definition at line 311 of file ustring.cpp.

◆ UString() [6/9]

KJS::UString::UString ( const UString &  s)
inline

Copy constructor.

Makes a shallow copy only.

Definition at line 257 of file ustring.h.

◆ UString() [7/9]

KJS::UString::UString ( const TQString &  )

Convenience declaration only ! You'll be on your own to write the implementation for a construction from TQString.

Note: feel free to contact me if you want to see a dummy header for your favorite FooString class here !

◆ UString() [8/9]

KJS::UString::UString ( const DOM::DOMString &  )

Convenience declaration only ! See UString(const TQString&).

◆ UString() [9/9]

UString::UString ( const UString &  a,
const UString &  b 
)

Concatenation constructor.

Makes operator+ more efficient.

Definition at line 326 of file ustring.cpp.

◆ ~UString()

KJS::UString::~UString ( )
inline

Destructor.

If this handle was the only one holding a reference to the string the data will be freed.

Definition at line 278 of file ustring.h.

Member Function Documentation

◆ append()

UString & UString::append ( const UString &  t)

Append another string.

Definition at line 458 of file ustring.cpp.

◆ ascii()

char * UString::ascii ( ) const

Convert the Unicode string to plain ASCII chars chopping of any higher bytes.

This method should only be used for debugging purposes as it is neither Unicode safe nor free from side effects. In order not to waste any memory the char buffer is static and shared by all UString instances.

Definition at line 486 of file ustring.cpp.

◆ cstring()

CString UString::cstring ( ) const
Returns
The string converted to the 8-bit string type CString().

Definition at line 481 of file ustring.cpp.

◆ data()

const UChar* KJS::UString::data ( ) const
inline
Returns
A pointer to the internal Unicode data.

Definition at line 340 of file ustring.h.

◆ find()

int UString::find ( const UString &  f,
int  pos = 0 
) const
Returns
Position of first occurrence of f starting at position pos. -1 if the search was not successful.

Definition at line 799 of file ustring.cpp.

◆ from() [1/4]

UString UString::from ( double  d)
static

Constructs a string from a double.

Definition at line 390 of file ustring.cpp.

◆ from() [2/4]

UString UString::from ( int  i)
static

Constructs a string from an int.

Definition at line 341 of file ustring.cpp.

◆ from() [3/4]

UString UString::from ( long  l)
static

Constructs a string from a long.

Definition at line 364 of file ustring.cpp.

◆ from() [4/4]

UString UString::from ( unsigned int  u)
static

Constructs a string from an unsigned int.

Definition at line 346 of file ustring.cpp.

◆ is8Bit()

bool UString::is8Bit ( ) const

Use this if you want to make sure that this string is a plain ASCII string.

For example, if you don't want to lose any information when using cstring() or ascii().

Returns
True if the string doesn't contain any non-ASCII characters.

Definition at line 550 of file ustring.cpp.

◆ isEmpty()

bool KJS::UString::isEmpty ( ) const
inline
Returns
True if null or zero length.

Definition at line 348 of file ustring.h.

◆ isNull()

bool KJS::UString::isNull ( ) const
inline
Returns
True if null.

Definition at line 344 of file ustring.h.

◆ operator+=()

UString& KJS::UString::operator+= ( const UString &  s)
inline

Appends the specified string.

Definition at line 335 of file ustring.h.

◆ operator=()

UString & UString::operator= ( const char *  c)

Assignment operator.

Definition at line 523 of file ustring.cpp.

◆ operator[]() [1/2]

UCharReference UString::operator[] ( int  pos)

Writable reference to character at specified position.

Definition at line 571 of file ustring.cpp.

◆ operator[]() [2/2]

UChar UString::operator[] ( int  pos) const

Const character at specified position.

Definition at line 563 of file ustring.cpp.

◆ qconststring()

TQConstString KJS::UString::qconststring ( ) const
See also
UString(const TQString&).

◆ qstring()

TQString KJS::UString::qstring ( ) const
See also
UString(const TQString&).

◆ rfind()

int UString::rfind ( const UString &  f,
int  pos 
) const
Returns
Position of first occurrence of f searching backwards from position pos. -1 if the search was not successful.

Definition at line 833 of file ustring.cpp.

◆ size()

int KJS::UString::size ( ) const
inline
Returns
The length of the string.

Definition at line 360 of file ustring.h.

◆ string()

DOM::DOMString KJS::UString::string ( ) const
See also
UString(const TQString&).

◆ substr()

UString UString::substr ( int  pos = 0,
int  len = -1 
) const
Returns
The sub string starting at position pos and length len.

Definition at line 869 of file ustring.cpp.

◆ toArrayIndex()

unsigned UString::toArrayIndex ( bool *  ok = 0) const

Attempts an conversion to an array index.

The "ok" boolean will be set to true if it is a valid array index according to the rule from ECMA 15.2 about what an array index is. It must exactly match the string form of an unsigned integer, and be less than 2^32 - 1.

Definition at line 791 of file ustring.cpp.

◆ toDouble()

double UString::toDouble ( bool  tolerateTrailingJunk,
bool  tolerateEmptyString 
) const

Attempts an conversion to a number.

Apart from floating point numbers, the algorithm will recognize hexadecimal representations (as indicated by a 0x or 0X prefix) and +/- Infinity. Returns NaN if the conversion failed.

Parameters
tolerateTrailingJunkif true, toDouble can tolerate garbage after the number.
tolerateEmptyStringif false, toDouble will turn an empty string into NaN rather than 0.

Definition at line 608 of file ustring.cpp.

◆ toLower()

UString UString::toLower ( ) const

Returns this string converted to lower case characters.

Definition at line 707 of file ustring.cpp.

◆ toULong()

unsigned long UString::toULong ( bool *  ok,
bool  tolerateEmptyString 
) const

Attempts an conversion to an unsigned long integer.

ok will be set according to the success. @param ok make this point to a bool in case you need to know whether the conversion succeeded.

Parameters
tolerateEmptyStringif false, toULong will return false for *ok for an empty string.

Definition at line 686 of file ustring.cpp.

◆ toUpper()

UString UString::toUpper ( ) const

Returns this string converted to upper case characters.

Definition at line 715 of file ustring.cpp.

Member Data Documentation

◆ null

UString UString::null
static

Static instance of a null string.

Definition at line 429 of file ustring.h.


The documentation for this class was generated from the following files:
  • ustring.h
  • ustring.cpp

kjs

Skip menu "kjs"
  • Main Page
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Class Members
  • Related Pages

kjs

Skip menu "kjs"
  • arts
  • dcop
  • dnssd
  • interfaces
  •     interface
  •     library
  •   kspeech
  •   ktexteditor
  • kabc
  • kate
  • kcmshell
  • kdecore
  • kded
  • kdefx
  • kdeprint
  • kdesu
  • kdeui
  • kdoctools
  • khtml
  • kimgio
  • kinit
  • kio
  •   bookmarks
  •   httpfilter
  •   kfile
  •   kio
  •   kioexec
  •   kpasswdserver
  •   kssl
  • kioslave
  •   http
  • kjs
  • kmdi
  •   kmdi
  • knewstuff
  • kparts
  • krandr
  • kresources
  • kspell2
  • kunittest
  • kutils
  • kwallet
  • libkmid
  • libkscreensaver
Generated for kjs by doxygen 1.9.1
This website is maintained by Timothy Pearson.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. |