nsACString_internal 编辑

Class Declaration

nsTSubstring is the most abstract class in the string hierarchy. It
represents a single contiguous array of characters, which may or may not
be null-terminated. This type is not instantiated directly.  A sub-class
is instantiated instead.  For example, see nsTString.

NAMES:
nsAString for wide characters
nsACString for narrow characters

Many of the accessors on nsTSubstring are inlined as an optimization.

<map id="classes" name="classes"> <area alt="" coords="456,5,605,53" href="http://developer.mozilla.org/en/nsACString_internal" shape="rect" title="nsACString_internal"> <area alt="" coords="415,101,497,149" href="http://developer.mozilla.org/en/nsCString" shape="rect" title="nsCString"> <area alt="" coords="521,101,689,149" href="http://developer.mozilla.org/en/nsDependentCSubstring" shape="rect" title="nsDependentCSubstring"> <area alt="" coords="172,197,289,245" href="http://developer.mozilla.org/en/nsFixedCString" shape="rect" title="nsFixedCString"> <area alt="" coords="315,197,437,245" href="http://developer.mozilla.org/en/nsXPIDLCString" shape="rect" title="nsXPIDLCString"> <area alt="" coords="461,197,611,245" href="http://developer.mozilla.org/en/nsDependentCString" shape="rect" title="nsDependentCString"> <area alt="" coords="635,197,787,245" href="http://developer.mozilla.org/en/nsPromiseFlatCString" shape="rect" title="nsPromiseFlatCString"> <area alt="" coords="173,293,285,341" href="http://developer.mozilla.org/en/nsCAutoString" shape="rect" title="nsCAutoString"> <area alt="" coords="5,389,227,437" href="http://developer.mozilla.org/en/NS_LossyConvertUTF16toASCII" shape="rect" title="NS_LossyConvertUTF16toASCII"> <area alt="" coords="251,389,435,437" href="http://developer.mozilla.org/en/NS_ConvertUTF16toUTF8" shape="rect" title="NS_ConvertUTF16toUTF8"> <area alt="" coords="309,293,445,341" href="http://developer.mozilla.org/en/nsAdoptingCString" shape="rect" title="nsAdoptingCString"> </map>

Method Overview

Constructors

BeginReading

EndReading

BeginWriting

EndWriting

Data

Length

IsEmpty

IsVoid

IsTerminated

CharAt

operator[]

First

Last

CountChar

FindChar

Equals

EqualsASCII

EqualsLiteral(const char

EqualsLiteral(char

LowerCaseEqualsASCII

LowerCaseEqualsLiteral(const char

LowerCaseEqualsLiteral(char

Assign

AssignASCII

AssignLiteral(const char

AssignLiteral(char

operator=

Adopt

Replace

ReplaceASCII

Append

AppendASCII

AppendLiteral(const char

AppendLiteral(char

operator+=

Insert

Cut

SetCapacity

SetLength

Truncate

GetData

GetMutableData

SetIsVoid

StripChar

Data Members

No public members.

Methods

Constructors

void nsACString_internal(const nsCSubstringTuple&) - source

this is public to support automatic conversion of tuple to string
base type, which helps avoid converting to nsTAString.

Parameters

• nsCSubstringTuple& tuple

void nsACString_internal(char*, PRUint32, PRUint32) - source

Parameters

• char* data
• PRUint32 length
• PRUint32 flags

BeginReading

char* BeginReading() const - source

reading iterators

nsReadingIterator<char>& BeginReading(nsReadingIterator<char>&) const - source

deprecated reading iterators

Parameters

• nsReadingIterator<char>& iter

char*& BeginReading(const char*&) const - source

Parameters

• char*& iter

EndReading

char* EndReading() const - source

nsReadingIterator<char>& EndReading(nsReadingIterator<char>&) const - source

Parameters

• nsReadingIterator<char>& iter

char*& EndReading(const char*&) const - source

Parameters

• char*& iter

BeginWriting

char* BeginWriting() - source

writing iterators

nsWritingIterator<char>& BeginWriting(nsWritingIterator<char>&) - source

deprecated writing iterators

Parameters

• nsWritingIterator<char>& iter

char*& BeginWriting(char*&) - source

Parameters

• char*& iter

EndWriting

char* EndWriting() - source

nsWritingIterator<char>& EndWriting(nsWritingIterator<char>&) - source

Parameters

• nsWritingIterator<char>& iter

char*& EndWriting(char*&) - source

Parameters

• char*& iter

Data

char* Data() const - source

accessors

Length

PRUint32 Length() const - source

IsEmpty

PRBool IsEmpty() const - source

IsVoid

PRBool IsVoid() const - source

IsTerminated

PRBool IsTerminated() const - source

CharAt

char CharAt(PRUint32) const - source

Parameters

• PRUint32 i

operator[]

char operator[](PRUint32) const - source

Parameters

• PRUint32 i

First

char First() const - source

Last

char Last() const - source

CountChar

PRUint32 CountChar(char) const - source

Parameters

• char <anonymous>

FindChar

PRInt32 FindChar(char, PRUint32) const - source

Parameters

• char <anonymous>
• PRUint32 offset

Equals

PRBool Equals(const nsACString_internal&) const - source

equality

Parameters

• nsACString_internal& <anonymous>

PRBool Equals(const nsACString_internal&, const nsCStringComparator&) const - source

Parameters

• nsACString_internal& <anonymous>
• nsCStringComparator& <anonymous>

PRBool Equals(const char*) const - source

Parameters

• char* data

PRBool Equals(const char*, const nsCStringComparator&) const - source

Parameters

• char* data
• nsCStringComparator& comp

EqualsASCII

PRBool EqualsASCII(const char*, PRUint32) const - source

An efficient comparison with ASCII that can be used even
for wide strings. Call this version when you know the
length of 'data'.

Parameters

• char* data
• PRUint32 len

PRBool EqualsASCII(const char*) const - source

An efficient comparison with ASCII that can be used even
for wide strings. Call this version when 'data' is
null-terminated.

Parameters

• char* data

EqualsLiteral(const char

PRBool EqualsLiteral(const char (&)[N]) const - source

EqualsLiteral(char

PRBool EqualsLiteral(char (&)[N]) const - source

LowerCaseEqualsASCII

PRBool LowerCaseEqualsASCII(const char*, PRUint32) const - source

Parameters

• char* data
• PRUint32 len

PRBool LowerCaseEqualsASCII(const char*) const - source

Parameters

• char* data

LowerCaseEqualsLiteral(const char

PRBool LowerCaseEqualsLiteral(const char (&)[N]) const - source

LowerCaseEqualsLiteral(char

PRBool LowerCaseEqualsLiteral(char (&)[N]) const - source

Assign

void Assign(char) - source

assignment

Parameters

• char c

void Assign(const char*, PRUint32) - source

Parameters

• char* data
• PRUint32 length

void Assign(const nsACString_internal&) - source

Parameters

• nsACString_internal& <anonymous>

void Assign(const nsCSubstringTuple&) - source

Parameters

• nsCSubstringTuple& <anonymous>

AssignASCII

void AssignASCII(const char*, PRUint32) - source

Parameters

• char* data
• PRUint32 length

void AssignASCII(const char*) - source

Parameters

• char* data

AssignLiteral(const char

void AssignLiteral(const char (&)[N]) - source

AssignLiteral(char

void AssignLiteral(char (&)[N]) - source

operator=

nsACString_internal& operator=(char) - source

Parameters

• char c

nsACString_internal& operator=(const char*) - source

Parameters

• char* data

nsACString_internal& operator=(const nsACString_internal&) - source

Parameters

• nsACString_internal& str

nsACString_internal& operator=(const nsCSubstringTuple&) - source

Parameters

• nsCSubstringTuple& tuple

Adopt

void Adopt(char*, PRUint32) - source

Parameters

• char* data
• PRUint32 length

Replace

void Replace(PRUint32, PRUint32, char) - source

buffer manipulation

Parameters

• PRUint32 cutStart
• PRUint32 cutLength
• char c

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

Parameters

• PRUint32 cutStart
• PRUint32 cutLength
• char* data
• PRUint32 length

void Replace(PRUint32, PRUint32, const nsACString_internal&) - source

Parameters

• PRUint32 cutStart
• PRUint32 cutLength
• nsACString_internal& str

void Replace(PRUint32, PRUint32, const nsCSubstringTuple&) - source

Parameters

• PRUint32 cutStart
• PRUint32 cutLength
• nsCSubstringTuple& tuple

ReplaceASCII

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

Parameters

• PRUint32 cutStart
• PRUint32 cutLength
• char* data
• PRUint32 length

Append

void Append(char) - source

Parameters

• char c

void Append(const char*, PRUint32) - source

Parameters

• char* data
• PRUint32 length

void Append(const nsACString_internal&) - source

Parameters

• nsACString_internal& str

void Append(const nsCSubstringTuple&) - source

Parameters

• nsCSubstringTuple& tuple

AppendASCII

void AppendASCII(const char*, PRUint32) - source

Parameters

• char* data
• PRUint32 length

AppendLiteral(const char

void AppendLiteral(const char (&)[N]) - source

AppendLiteral(char

void AppendLiteral(char (&)[N]) - source

operator+=

nsACString_internal& operator+=(char) - source

Parameters

• char c

nsACString_internal& operator+=(const char*) - source

Parameters

• char* data

nsACString_internal& operator+=(const nsACString_internal&) - source

Parameters

• nsACString_internal& str

nsACString_internal& operator+=(const nsCSubstringTuple&) - source

Parameters

• nsCSubstringTuple& tuple

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_internal&, PRUint32) - source

Parameters

• nsACString_internal& str
• PRUint32 pos

void Insert(const nsCSubstringTuple&, PRUint32) - source

Parameters

• nsCSubstringTuple& tuple
• PRUint32 pos

Cut

void Cut(PRUint32, PRUint32) - source

Parameters

• PRUint32 cutStart
• PRUint32 cutLength

SetCapacity

void SetCapacity(PRUint32) - source

buffer sizing

Parameters

• PRUint32 newCapacity

SetLength

void SetLength(PRUint32) - source

Parameters

• PRUint32 newLength

Truncate

void Truncate(PRUint32) - source

Parameters

• PRUint32 newLength

GetData

PRUint32 GetData(const char**) const - source

Get a const pointer to the string's internal buffer.  The caller
MUST NOT modify the characters at the returned address.

@returns The length of the buffer in characters.

Parameters

• char** data

GetMutableData

PRUint32 GetMutableData(char**, PRUint32) - source

Get a pointer to the string's internal buffer, optionally resizing
the buffer first.  If size_type(-1) is passed for newLen, then the
current length of the string is used.  The caller MAY modify the
characters at the returned address (up to but not exceeding the
length of the string).

@returns The length of the buffer in characters or 0 if unable to
satisfy the request due to low-memory conditions.

Parameters

• char** data
• PRUint32 newLen

SetIsVoid

void SetIsVoid(PRBool) - source

string data is never null, but can be marked void.  if true, the
string will be truncated.  @see nsTSubstring::IsVoid

Parameters

• PRBool <anonymous>

StripChar

void StripChar(char, PRInt32) - source

This method is used to remove all occurrences of aChar from this
string.

@param  aChar -- char to be stripped
@param  aOffset -- where in this string to start stripping chars

Parameters

• char aChar
• PRInt32 aOffset