当前位置：文江博客知识库 en-US 文档 Mozilla Tech XPCOM Reference Glue_classes nsDependentCSubstring

nsDependentCSubstring 编辑

nsTDependentSubstring_CharT

A string class which wraps an external array of string characters. It
is the client code's responsibility to ensure that the external buffer
remains valid for a long as the string is alive.

NAMES:
nsDependentSubstring for wide characters
nsDependentCSubstring for narrow characters

Method Overview

Base Classes

nsACString_internal

Data Members

No public members.

Methods

Constructors

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

Parameters

nsACString_internal& str
PRUint32 startPos
PRUint32 length

void nsDependentCSubstring(const char*, const char*) - source

Parameters

char* start
char* end

void nsDependentCSubstring(const nsReadingIterator<char>&, const nsReadingIterator<char>&) - source

Parameters

nsReadingIterator<char>& start
nsReadingIterator<char>& end

void nsDependentCSubstring() - source

Rebind

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

Parameters

nsACString_internal& <anonymous>
PRUint32 startPos
PRUint32 length

void Rebind(const char*, const char*) - source

Parameters

char* start
char* end

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