Class Declaration

Method Overview

BeginReading
EndReading
CharAt
operator[]
First
BeginWriting
EndWriting
SetLength
Length
IsEmpty
SetIsVoid
IsVoid
Assign
AssignLiteral
operator=
Replace
Append
AppendLiteral
operator+=
Insert
Cut
Truncate
StripChars
StripWhitespace
Trim
DefaultComparator
Compare(const char*, PRInt32 (*)
Compare(const nsACString&, PRInt32 (*)
Equals(const char*, PRInt32 (*)
Equals(const nsACString&, PRInt32 (*)
operator<
operator<=
operator==
operator>=
operator>
operator!=
EqualsLiteral
Find(const nsACString&, PRInt32 (*)
Find(const nsACString&, PRUint32, PRInt32 (*)
Find(const char*, PRInt32 (*)
Find(const char*, PRUint32, PRInt32 (*)
RFind(const nsACString&, PRInt32 (*)
RFind(const nsACString&, PRInt32, PRInt32 (*)
RFind(const char*, PRInt32 (*)
RFind(const char*, PRInt32, PRInt32 (*)
FindChar
RFindChar
AppendInt
ToInteger

Base Classes

Data Members

No public members.

Methods

BeginReading

PRUint32 BeginReading(const char**, const char**) const - source
Returns the length, beginning, and end of a string in one operation.

Parameters

  • char* begin
  • char* end
char BeginReading() const - source
 

EndReading

char EndReading() const - source
 

CharAt

char CharAt(PRUint32) const - source

Parameters

  • PRUint32 aPos

operator[]

char operator[](PRUint32) const - source

Parameters

  • PRUint32 aPos

First

char First() const - source
 

BeginWriting

PRUint32 BeginWriting(char**, char**, PRUint32) - source
Get the length, begin writing, and optionally set the length of a
string all in one operation.

@param   newSize Size the string to this length. Pass PR_UINT32_MAX
to leave the length unchanged.
@return  The new length of the string, or 0 if resizing failed.

Parameters

  • char* begin
  • char* end
  • PRUint32 newSize
char BeginWriting(PRUint32) - source

Parameters

  • PRUint32 aLen

EndWriting

char EndWriting() - source
 

SetLength

PRBool SetLength(PRUint32) - source

Parameters

  • PRUint32 aLen

Length

PRUint32 Length() const - source
 

IsEmpty

PRBool IsEmpty() const - source
 

SetIsVoid

void SetIsVoid(PRBool) - source

Parameters

  • PRBool val

IsVoid

PRBool IsVoid() const - source
 

Assign

void Assign(const nsACString&) - source

Parameters

  • nsACString aString
void Assign(const char*, PRUint32) - source

Parameters

  • char aData
  • PRUint32 aLength
void Assign(char) - source

Parameters

  • char aChar

AssignLiteral

void AssignLiteral(const char*) - source

Parameters

  • char aData

operator=

nsACString operator=(const nsACString&) - source

Parameters

  • nsACString aString
nsACString operator=(const char*) - source

Parameters

  • char aPtr
nsACString operator=(char) - source

Parameters

  • char aChar

Replace

void Replace(PRUint32, PRUint32, const char*, PRUint32) - source

Parameters

  • PRUint32 cutStart
  • PRUint32 cutLength
  • char data
  • PRUint32 length
void Replace(PRUint32, PRUint32, char) - source

Parameters

  • PRUint32 cutStart
  • PRUint32 cutLength
  • char c
void Replace(PRUint32, PRUint32, const nsACString&) - source

Parameters

  • PRUint32 cutStart
  • PRUint32 cutLength
  • nsACString readable

Append

void Append(char) - source

Parameters

  • char c
void Append(const char*, PRUint32) - source

Parameters

  • char data
  • PRUint32 length
void Append(const nsACString&) - source

Parameters

  • nsACString readable

AppendLiteral

void AppendLiteral(const char*) - source

Parameters

  • char aASCIIStr

operator+=

nsACString operator+=(char) - source

Parameters

  • char c
nsACString operator+=(const char*) - source

Parameters

  • char data
nsACString operator+=(const nsACString&) - source

Parameters

  • nsACString readable

Insert

void Insert(char, PRUint32) - source

Parameters

  • char c
  • PRUint32 pos
void Insert(const char*, PRUint32, PRUint32) - source

Parameters

  • char data
  • PRUint32 pos
  • PRUint32 length
void Insert(const nsACString&, PRUint32) - source

Parameters

  • nsACString readable
  • PRUint32 pos

Cut

void Cut(PRUint32, PRUint32) - source

Parameters

  • PRUint32 cutStart
  • PRUint32 cutLength

Truncate

void Truncate() - source
 

StripChars

void StripChars(const char*) - source
Remove all occurrences of characters in aSet from the string.

Parameters

  • char aSet

StripWhitespace

void StripWhitespace() - source
Strip whitespace characters from the string.

Trim

void Trim(const char*, PRBool, PRBool) - source

Parameters

  • char aSet
  • PRBool aLeading
  • PRBool aTrailing

DefaultComparator

PRInt32 DefaultComparator(const char*, const char*, PRUint32) - source

Parameters

  • char a
  • char b
  • PRUint32 length

Compare(const char*, PRInt32 (*)

PRInt32 Compare(const char*, PRInt32 (*)(const char*, const char*, PRUint32)) const - source

Parameters

  • char other
  • PRInt32* c

Compare(const nsACString&, PRInt32 (*)

PRInt32 Compare(const nsACString&, PRInt32 (*)(const char*, const char*, PRUint32)) const - source

Parameters

  • nsACString other
  • PRInt32* c

Equals(const char*, PRInt32 (*)

PRBool Equals(const char*, PRInt32 (*)(const char*, const char*, PRUint32)) const - source

Parameters

  • char other
  • PRInt32* c

Equals(const nsACString&, PRInt32 (*)

PRBool Equals(const nsACString&, PRInt32 (*)(const char*, const char*, PRUint32)) const - source

Parameters

  • nsACString other
  • PRInt32* c

operator<

PRBool operator<(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator<(const char*) const - source

Parameters

  • char other

operator<=

PRBool operator<=(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator<=(const char*) const - source

Parameters

  • char other

operator==

PRBool operator==(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator==(const char*) const - source

Parameters

  • char other

operator>=

PRBool operator>=(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator>=(const char*) const - source

Parameters

  • char other

operator>

PRBool operator>(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator>(const char*) const - source

Parameters

  • char other

operator!=

PRBool operator!=(const nsACString&) const - source

Parameters

  • nsACString other
PRBool operator!=(const char*) const - source

Parameters

  • char other

EqualsLiteral

PRBool EqualsLiteral(const char*) const - source

Parameters

  • char other

Find(const nsACString&, PRInt32 (*)

PRInt32 Find(const nsACString&, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the first occurrence of aStr in this string.

@return the offset of aStr, or -1 if not found

Parameters

  • nsACString aStr
  • PRInt32* c

Find(const nsACString&, PRUint32, PRInt32 (*)

PRInt32 Find(const nsACString&, PRUint32, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the first occurrence of aStr in this string, beginning at aOffset.

@return the offset of aStr, or -1 if not found

Parameters

  • nsACString aStr
  • PRUint32 aOffset
  • PRInt32* c

Find(const char*, PRInt32 (*)

PRInt32 Find(const char*, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the first occurrence of aStr in this string.

@return the offset of aStr, or -1 if not found

Parameters

  • char aStr
  • PRInt32* c

Find(const char*, PRUint32, PRInt32 (*)

PRInt32 Find(const char*, PRUint32, PRInt32 (*)(const char*, const char*, PRUint32)) const - source

Parameters

  • char aStr
  • PRUint32 aLen
  • PRInt32* c

RFind(const nsACString&, PRInt32 (*)

PRInt32 RFind(const nsACString&, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the last occurrence of aStr in this string.

@return The offset of the character from the beginning of the string,
or -1 if not found.

Parameters

  • nsACString aStr
  • PRInt32* c

RFind(const nsACString&, PRInt32, PRInt32 (*)

PRInt32 RFind(const nsACString&, PRInt32, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the last occurrence of aStr in this string, beginning at aOffset.

@param aOffset the offset from the beginning of the string to begin
searching. If aOffset < 0, search from end of this string.
@return The offset of aStr from the beginning of the string,
or -1 if not found.

Parameters

  • nsACString aStr
  • PRInt32 aOffset
  • PRInt32* c

RFind(const char*, PRInt32 (*)

PRInt32 RFind(const char*, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the last occurrence of aStr in this string.

@return The offset of aStr from the beginning of the string,
or -1 if not found.

Parameters

  • char aStr
  • PRInt32* c

RFind(const char*, PRInt32, PRInt32 (*)

PRInt32 RFind(const char*, PRInt32, PRInt32 (*)(const char*, const char*, PRUint32)) const - source
Find the last occurrence of an ASCII string in this string,
beginning at aOffset.

@param aLen is the length of aStr
@return The offset of aStr from the beginning of the string,
or -1 if not found.

Parameters

  • char aStr
  • PRInt32 aLen
  • PRInt32* c

FindChar

PRInt32 FindChar(char, PRUint32) const - source
Search for the offset of the first occurrence of a character in a
string.

@param aOffset the offset from the beginning of the string to begin
searching
@return The offset of the character from the beginning of the string,
or -1 if not found.

Parameters

  • char aChar
  • PRUint32 aOffset

RFindChar

PRInt32 RFindChar(char) const - source
Search for the offset of the last occurrence of a character in a
string.

@return The offset of the character from the beginning of the string,
or -1 if not found.

Parameters

  • char aChar

AppendInt

void AppendInt(int, PRInt32) - source
Append a string representation of a number.

Parameters

  • int aInt
  • PRInt32 aRadix

ToInteger

PRInt32 ToInteger(nsresult*, PRUint32) const - source
Convert this string to an integer.

@param aErrorCode pointer to contain result code.
@param aRadix must be 10 or 16

Parameters

  • nsresult aErrorCode
  • PRUint32 aRadix