Contents Up Previous Next 原文へのリンク

wxString

wxString wxStringは文字列を表すクラスです。 これに関する詳しい情報に関してwxStringの概要を見てください。 そこで説明されるように、wxStringはstd::stringのメソッドの約90%を実装しています。 (iteratorはサポートしていないので、それを使用するすべてのメソッドも未サポート)。 これらの標準関数はこのマニュアルには記述されないので、STLドキュメンテーションを参照してください。 これらのすべての機能のふるまいはそこで説明されたふるまいと同じです。
wxString is a class representing a character string. Please see the wxString overview for more information about it. As explained there, wxString implements about 90% of methods of the std::string class (iterators are not supported, nor all methods which use them). These standard functions are not documented in this manual so please see the STL documentation. The behaviour of all these functions is identical to the behaviour described there.

Derived from

None

Include files

<wx/string.h>

Predefined objects

Objects:

wxEmptyString

See also

Overview

Function groups

Constructors and assignment operators
String length
Character access
Concatenation
Comparison
Substring extraction
Case conversion
Searching and replacing
Conversion to numbers
Writing values into the string
Memory management
Miscellaneous
wxWidgets 1.xx compatibility functions
std::string compatibility functions
wxString::wxString
wxString::~wxString
wxString::Alloc
wxString::Append
wxString::AfterFirst
wxString::AfterLast
wxString::BeforeFirst
wxString::BeforeLast
wxString::c_str
wxString::Clear
wxString::Cmp
wxString::CmpNoCase
wxString::CompareTo
wxString::Contains
wxString::Empty
wxString::Find
wxString::First
wxString::Format
wxString::FormatV
wxString::Freq
wxString::GetChar
wxString::GetData
wxString::GetWritableChar
wxString::GetWriteBuf
wxString::Index
wxString::IsAscii
wxString::IsEmpty
wxString::IsNull
wxString::IsNumber
wxString::IsSameAs
wxString::IsSameAs
wxString::IsWord
wxString::Last
wxString::Left
wxString::Len
wxString::Length
wxString::Lower
wxString::LowerCase
wxString::MakeLower
wxString::MakeUpper
wxString::Matches
wxString::Mid
wxString::Pad
wxString::Prepend
wxString::Printf
wxString::PrintfV
wxString::Remove
wxString::RemoveLast
wxString::Replace
wxString::Right
wxString::SetChar
wxString::Shrink
wxString::sprintf
wxString::StartsWith
wxString::Strip
wxString::SubString
wxString::ToDouble
wxString::ToLong
wxString::ToULong
wxString::Trim
wxString::Truncate
wxString::UngetWriteBuf
wxString::Upper
wxString::UpperCase
wxString::operator!
wxString::operator =
wxString::operator +
wxString::operator +=
wxString::operator []
wxString::operator ()
wxString::operator <<
wxString::operator >>
wxString::operator const char*
Comparison operators


Constructors and assignment operators

文字列は8bitの文字かあるいは wide (UNICODE) 文字のC文字列(のいくつかのコピー)から生成される。すべてのコンストラクタは代入演算子と一致する(例外としてデフォルトコンストラクタは空の文字列を作成する)
A string may be constructed either from a C string, (some number of copies of) a single character or a wide (UNICODE) string. For all constructors (except the default which creates an empty string) there is also a corresponding assignment operator.

wxString
operator =
~wxString


String length

これらの関数は文字列の長さを返したり、文字列が空かどうかをチェックしたり、文字列を空にしたりする。
These functions return the string length and check whether the string is empty or empty it.

Len
IsEmpty
operator!
Empty
Clear


Character access

このセクションのいくつかの関数は文字列内の文字要素の位置を引数として使用する。C文字列と同様および/または配列と同様、番号は0から始まる。つまり、文字列の最初の文字はstring[0]になる。文字列の最後を超えたところの文字をアクセスしようとすると、debug buildの場合は例外を引き起こすが、リリース用構築の場合は何もチェックを行なわない。
Many functions in this section take a character index in the string. As with C strings and/or arrays, the indices start from 0, so the first character of a string is string[0]. Attempt to access a character beyond the end of the string (which may be even 0 if the string is empty) will provoke an assert failure in debug build, but no checks are done in release builds.

この項で説明されている事項は、C文字列への暗黙的なおよび明示的な変換の両方を含んでいる。暗黙的な変換の方が便利に見えるが、c_str()を用いた明示的な変換を使用することを勧める。明示的な変換をする必要がある事例についてはoverviewを参照すること。
sectionはclassの間違い?
This section also contains both implicit and explicit conversions to C style strings. Although implicit conversion is quite convenient, it is advised to use explicit c_str() method for the sake of clarity. Also see overview for the cases where it is necessary to use it.

GetChar
GetWritableChar
SetChar
Last
operator []
c_str
operator const char*


Concatenation

全ては文字列と連携する (付け足す) ことができる。たとえば、 (文字内容をもつ) C文字列に何かを付加することはできないので、付加するためにまずwxStringに変換する必要がある。
Anything may be concatenated (appended to) with a string. However, you can't append something to a C string (including literal constants), so to do this it should be converted to a wxString first.

operator <<
operator +=
operator +
Append
Prepend


Comparison

既定値として使われる比較関数Cmpは、大文字と小文字を区別し、そしてIsSameAsにおいて、引数で指定の無かった時のものと同じ関数でもある。大文字小文字を比較しない場合はCmpNoCaseを使用するか、IsSameAsの第2引数を指定しなくてはならない。後の関数(CmpNoCase/IsSameAs)は、もし文字列の内容が同じだけれども (大文字と小文字の違いのために) Cmp()では0以外の (通常はCにおいては0でFALSEを表す) 値を返すような時でもtrueを返すので、文字列の内容が同じかどうかを確認したいときにより便利な関数である。
The default comparison function Cmp is case-sensitive and so is the default version of IsSameAs. For case insensitive comparisons you should use CmpNoCase or give a second parameter to IsSameAs. This last function is may be more convenient if only equality of the strings matters because it returns a boolean true value if the strings are the same and not 0 (which is usually FALSE in C) as Cmp() does.

Matchesは、貧弱な man の正規表現エンジンである。man の正規表現は'*'と'?'のメタ文字のみを理解する、ある意味DOSのコマンドラインインタプリタのような正規表現のことである。
Matches is a poor man's regular expression matcher: it only understands '*' and '?' metacharacters in the sense of DOS command line interpreter.

StartsWithは、あらかじめ定められた接頭辞で始まる文章を構文解析する時に有益な、また文字列の先頭から (あらかじめ算出した) 接頭辞の長さ分を切出した文字列と接頭辞を直接比較するよりも効率的な関数である。
StartsWith is helpful when parsing a line of text which should start with some predefined prefix and is more efficient than doing direct string comparison as you would also have to precalculate the length of the prefix then.

Cmp
CmpNoCase
IsSameAs
Matches
StartsWith


Substring extraction

これらの関数は文字列から部分文字列を抽出することを可能にする。これら全ては元の文字列を変更せず、抽出された部分文字列を含む新しい文字列を返す。
These functions allow to extract substring from this string. All of them don't modify the original string and return a new string containing the extracted substring.

Mid
operator()
Left
Right
BeforeFirst
BeforeLast
AfterFirst
AfterLast
StartsWith


Case conversion

MakeXXX()の形をした変種は、与えられた文字列そのものをすべて大文字または小文字に変更する。XXX()は、元の文字列を変更することなしに、元の文字列の内容を大文字または小文字に取り換えた新しい文字列を返す。
The MakeXXX() variants modify the string in place, while the other functions return a new string which contains the original text converted to the upper or lower case and leave the original string unchanged.

MakeUpper
Upper
MakeLower
Lower


Searching and replacing

これらの関数は、標準のstrchr()strstr()を置き換えるものである。
These functions replace the standard strchr() and strstr() functions.

Find
Replace


Conversion to numbers

文字列は符号つき/符号無し整数および浮動小数点数への変換関数を備えている。これら3つの関数は数値を入れるための変数へのポインタを引数として受け取り、もし文字列全体が数値に変更可能な場合はTRUEを返す。
The string provides functions for conversion to signed and unsigned integer and floating point numbers. All three functions take a pointer to the variable to put the numeric value in and return TRUE if the entire string could be converted to a number.

ToLong
ToULong
ToDouble


Writing values into the string

書式指定版(Printf)とストリーム的な挿入演算子の両方が存在する。加えて、Format関数により簡単に文字列に書式化された値を追加できる。
Both formatted versions (Printf) and stream-like insertion operators exist (for basic types only). Additionally, the Format function allows to use simply append formatted value to a string:

    // the following 2 snippets are equivalent

    wxString s = "...";
    s += wxString::Format("%d", n);

    wxString s;
    s.Printf("...%d", n);
Format
FormatV
Printf
PrintfV
operator <<


Memory management

これらは『上級』関数で、まれにしか必要になることはない。 AllocShrinkは最適化をする目的のみに関係する。GetWriteBufは、呼び出しに対して書き込み用バッファを準備することを要求するような外部APIを利用するときに便利である。しかし、使用するときは極度の注意が必要である。文字列に対して他の操作を実行する前にUngetWriteBuf必ず呼出すこと!
These are "advanced" functions and they will be needed quite rarely. Alloc and Shrink are only interesting for optimization purposes. GetWriteBuf may be very useful when working with some external API which requires the caller to provide a writable buffer, but extreme care should be taken when using it: before performing any other operation on the string UngetWriteBuf must be called!

Alloc
Shrink
GetWriteBuf
UngetWriteBuf


Miscellaneous

その他の文字列関数
Other string functions.

Trim
Pad
Truncate


wxWidgets 1.xx compatibility functions

これらは使用するのが望ましくない関数である。新しいwxWidgets2.0の関数をこれらの代わりに使用すること。 (もしくは、代わりにstd::string互換の改良型を使用するほうがまだ望ましい) 。
These functions are deprecated, please consider using new wxWidgets 2.0 functions instead of them (or, even better, std::string compatible variants).

SubString
sprintf
CompareTo
Length
Freq
LowerCase
UpperCase
Strip
Index
Remove
First
Last
Contains
IsNull
IsAscii
IsNumber
IsWord


std::string compatibility functions

サポートされている関数のみがここに列記されている。これらの詳細資料としてはSTLリファレンスを参照すること
The supported functions are only listed here, please see any STL reference for their documentation.

    // take nLen chars starting at nPos
  wxString(const wxString& str, size_t nPos, size_t nLen);
    // take all characters from pStart to pEnd (poor man's iterators)
  wxString(const void *pStart, const void *pEnd);

  // lib.string.capacity
    // return the length of the string
  size_t size() const;
    // return the length of the string
  size_t length() const;
    // return the maximum size of the string
  size_t max_size() const;
    // resize the string, filling the space with c if c != 0
  void resize(size_t nSize, char ch = '\0');
    // delete the contents of the string
  void clear();
    // returns true if the string is empty
  bool empty() const;

  // lib.string.access
    // return the character at position n
  char at(size_t n) const;
    // returns the writable character at position n
  char& at(size_t n);

  // lib.string.modifiers
    // append a string
  wxString& append(const wxString& str);
    // append elements str[pos], ..., str[pos+n]
  wxString& append(const wxString& str, size_t pos, size_t n);
    // append first n (or all if n == npos) characters of sz
  wxString& append(const char *sz, size_t n = npos);

    // append n copies of ch
  wxString& append(size_t n, char ch);

    // same as `this_string = str'
  wxString& assign(const wxString& str);
    // same as ` = str[pos..pos + n]
  wxString& assign(const wxString& str, size_t pos, size_t n);
    // same as `= first n (or all if n == npos) characters of sz'
  wxString& assign(const char *sz, size_t n = npos);
    // same as `= n copies of ch'
  wxString& assign(size_t n, char ch);

    // insert another string
  wxString& insert(size_t nPos, const wxString& str);
    // insert n chars of str starting at nStart (in str)
  wxString& insert(size_t nPos, const wxString& str, size_t nStart, size_t n);

    // insert first n (or all if n == npos) characters of sz
  wxString& insert(size_t nPos, const char *sz, size_t n = npos);
    // insert n copies of ch
  wxString& insert(size_t nPos, size_t n, char ch);

    // delete characters from nStart to nStart + nLen
  wxString& erase(size_t nStart = 0, size_t nLen = npos);

    // replaces the substring of length nLen starting at nStart
  wxString& replace(size_t nStart, size_t nLen, const char* sz);
    // replaces the substring with nCount copies of ch
  wxString& replace(size_t nStart, size_t nLen, size_t nCount, char ch);
    // replaces a substring with another substring
  wxString& replace(size_t nStart, size_t nLen,
                    const wxString& str, size_t nStart2, size_t nLen2);
    // replaces the substring with first nCount chars of sz
    wxString& replace(size_t nStart, size_t nLen,
                      const char* sz, size_t nCount);

    // swap two strings
  void swap(wxString& str);

    // All find() functions take the nStart argument which specifies the
    // position to start the search on, the default value is 0. All functions
    // return npos if there were no match.

    // find a substring
  size_t find(const wxString& str, size_t nStart = 0) const;

    // find first n characters of sz
  size_t find(const char* sz, size_t nStart = 0, size_t n = npos) const;

    // find the first occurrence of character ch after nStart
  size_t find(char ch, size_t nStart = 0) const;

    // rfind() family is exactly like find() but works right to left

    // as find, but from the end
  size_t rfind(const wxString& str, size_t nStart = npos) const;

    // as find, but from the end
  size_t rfind(const char* sz, size_t nStart = npos,
          size_t n = npos) const;
    // as find, but from the end
  size_t rfind(char ch, size_t nStart = npos) const;

    // find first/last occurrence of any character in the set

    //
  size_t find_first_of(const wxString& str, size_t nStart = 0) const;
    //
  size_t find_first_of(const char* sz, size_t nStart = 0) const;
    // same as find(char, size_t)
  size_t find_first_of(char c, size_t nStart = 0) const;
    //
  size_t find_last_of (const wxString& str, size_t nStart = npos) const;
    //
  size_t find_last_of (const char* s, size_t nStart = npos) const;
    // same as rfind(char, size_t)
  size_t find_last_of (char c, size_t nStart = npos) const;

    // find first/last occurrence of any character not in the set

    //
  size_t find_first_not_of(const wxString& str, size_t nStart = 0) const;
    //
  size_t find_first_not_of(const char* s, size_t nStart = 0) const;
    //
  size_t find_first_not_of(char ch, size_t nStart = 0) const;
    //
  size_t find_last_not_of(const wxString& str, size_t nStart=npos) const;
    //
  size_t find_last_not_of(const char* s, size_t nStart = npos) const;
    //
  size_t find_last_not_of(char ch, size_t nStart = npos) const;

    // All compare functions return a negative, zero or positive value
    // if the [sub]string is less, equal or greater than the compare() argument.

    // just like strcmp()
  int compare(const wxString& str) const;
    // comparison with a substring
  int compare(size_t nStart, size_t nLen, const wxString& str) const;
    // comparison of 2 substrings
  int compare(size_t nStart, size_t nLen,
              const wxString& str, size_t nStart2, size_t nLen2) const;
    // just like strcmp()
  int compare(const char* sz) const;
    // substring comparison with first nCount characters of sz
  int compare(size_t nStart, size_t nLen,
              const char* sz, size_t nCount = npos) const;

  // substring extraction
  wxString substr(size_t nStart = 0, size_t nLen = npos) const;


wxString::wxString

wxString()

デフォルトコンストラクタ
Default constructor.

wxString(const wxString& x)

コピーコンストラクタ
Copy constructor.

wxString(char ch, size_t n = 1)

ch文字のn個のコピーを作成するコンストラクタ .

Constructs a string of n copies of character ch.

wxString(const char* psz, size_t nLength = wxSTRING_MAXLEN)

nLength個の文字をpszのC文字列から取得する。標準値のwxSTRING_MAXLENは、すべての文字列を取得することを意味する。
Takes first nLength characters from the C string psz. The default value of wxSTRING_MAXLEN means to take all the string.

このコンストラクタは たとえpszポインタがバイナリデータへのバッファ(例えばNUL文字を含む)だったとしても、指定されたnLengthの長さまでバッファを使用することに注意すること。また一方、省略時の書式では中間のNULまでの文字列しか取りこまない。何故なら、この関数は有効な長さを計算するのにstrlen()を使用しており、このような場合ではstrlen()は正しい値を返さないためである。
Note that this constructor may be used even if psz points to a buffer with binary data (i.e. containing NUL characters) as long as you provide the correct value for nLength. However, the default form of it works only with strings without intermediate NULs because it uses strlen() to calculate the effective length and it would not give correct results otherwise.

wxString(const unsigned char* psz, size_t nLength = wxSTRING_MAXLEN)

コンパイラのためにunsigned charを使用している。C文字列pszの最初からnLength個までの文字列を取得する。省略時の値wxSTRING_MAXLENは、全ての文字列を取得することを表す。
For compilers using unsigned char: takes first nLength characters from the C string psz. The default value of wxSTRING_MAXLEN means take all the string.

wxString(const wchar_t* psz)

wide (UNICODE)文字列から文字列を作成する。
Constructs a string from the wide (UNICODE) string.

wxString::~wxString

~wxString()

文字列のデストラクタ。デストラクタが仮想関数ではないので、wxStringから継承して派生クラスを作成することができないことに注意すること。
String destructor. Note that this is not virtual, so wxString must not be inherited from.


wxString::Alloc

void Alloc(size_t nLen)

wxStringがnLen個の文字を格納するのに十分な容量をあらかじめ確保する。この関数により、文字連結の繰り返しで文字列を作成する時に実行速度を改善することができる。
Preallocate enough space for wxString to store nLen characters. This function may be used to increase speed when the string is constructed by repeated concatenation as in

// delete all vowels from the string
wxString DeleteAllVowels(const wxString& original)
{
    wxString result;

    size_t len = original.length();

    result.Alloc(len);

    for ( size_t n = 0; n < len; n++ )
    {
        if ( strchr("aeuio", tolower(original[n])) == NULL )
            result += original[n];
    }

    return result;
}

なぜならば、 (長い文字列において) 文字列用のメモリを繰り返し再確保するのを回避するからである。なお、これは文字列の最大長を定めるのではないことに注意すること。nLenよりも多くの文字を格納することになった場合は、確保されたメモリはさらに拡張される。また、たとえ現在の文字の長さがnLenよりも長かったとしても、すでに存在する文字列を切り捨てることはない。(そのような用途にはTruncate()を使用すること)
because it will avoid the need of reallocating string memory many times (in case of long strings). Note that it does not set the maximal length of a string - it will still expand if more than nLen characters are stored in it. Also, it does not truncate the existing string (use Truncate() for this) even if its current length is greater than nLen


wxString::Append

wxString& Append(const char* psz)

pszをこの文字列に連結し、参照を返す。
Concatenates psz to this string, returning a reference to it.

wxString& Append(char ch, int count = 1)

文字chをこの文字列にcount回繰り返して連結し、参照を返す。
Concatenates character ch to this string, count times, returning a reference to it.


wxString::AfterFirst

wxString AfterFirst(char ch) const

chが最初に現れたところよりも後ろの文字全てを得る。もしchが無い場合は空の文字列を返す。
Gets all the characters after the first occurrence of ch. Returns the empty string if ch is not found.


wxString::AfterLast

wxString AfterLast(char ch) const

chが最後に現れたところよりも後ろの文字全てを得る。もしchが無い場合は空の文字列を返す。
Gets all the characters after the last occurrence of ch. Returns the whole string if ch is not found.


wxString::BeforeFirst

wxString BeforeFirst(char ch) const

chが最初に現れたところより前の文字全てを得る。もしchが無い場合は空の文字列を返す。
Gets all characters before the first occurrence of ch. Returns the whole string if ch is not found.


wxString::BeforeLast

wxString BeforeLast(char ch) const

chが最後に現れたところより後ろの文字全てを得る。もしchが無い場合は空の文字列を返す。
Gets all characters before the last occurrence of ch. Returns the empty string if ch is not found.


wxString::c_str

const char * c_str() const

文字列データへのポインタを返す。
Returns a pointer to the string data.


wxString::Clear

void Clear()

文字列を空にし、文字列が占有していたメモリを解放する。Emptyも参照のこと。
Empties the string and frees memory occupied by it.

See also: Empty


wxString::Cmp

int Cmp(const char* psz) const

大文字小文字を区別する比較。
Case-sensitive comparison.

もし文字列が変数よりも大きければ正の値を、もし等しければ0を、もし小さければ負の値を返す ( 標準関数のstrcmp()と同義)
Returns a positive value if the string is greater than the argument, zero if it is equal to it or a negative value if it is less than the argument (same semantics as the standard strcmp() function).

CmpNoCase, IsSameAsを参照のこと。
See also CmpNoCase, IsSameAs.


wxString::CmpNoCase

int CmpNoCase(const char* psz) const

大文字小文字を区別しない比較。
Case-insensitive comparison.

もし文字列が変数よりも大きければ正の値を、もし等しければ0を、もし小さければ負の値を返す ( 標準関数のstrcmp()と同義)
Returns a positive value if the string is greater than the argument, zero if it is equal to it or a negative value if it is less than the argument (same semantics as the standard strcmp() function).

Cmp, IsSameAsを参照のこと。
See also Cmp, IsSameAs.


wxString::CompareTo

#define NO_POS ((int)(-1)) // undefined position
enum caseCompare {exact, ignoreCase};
int CompareTo(const char* psz, caseCompare cmp = exact) const

大文字小文字を区別する比較。もし等しければ0を、もし大きければ1を、もし小さければ0を返す。
Case-sensitive comparison. Returns 0 if equal, 1 if greater or -1 if less.


wxString::Contains

bool Contains(const wxString& str) const

もし目標がwxStringに現れれば1を、さもなければ0を返す。
Returns 1 if target appears anyhere in wxString; else 0.


wxString::Empty

void Empty()

文字列を空にする。ただし文字列が占有していたメモリは解放しない。
Makes the string empty, but doesn't free memory occupied by the string.

Clear()を参照のこと
See also: Clear().


wxString::Find

int Find(char ch, bool fromEnd = FALSE) const

与えられた文字を検索する。開始位置か、もし見付からなければ-1を返す。
Searches for the given character. Returns the starting index, or -1 if not found.

int Find(const char* sz) const

与えられた文字列を検索する。開始位置か、もし見付からなければ-1を返す。
Searches for the given string. Returns the starting index, or -1 if not found.


wxString::First

size_t First(char c)

size_t First(const char* psz) const

size_t First(const wxString& str) const

size_t First(const char ch) const

最初に指定文字(列)が出現した位置を返す。
Returns the first occurrence of the item.


wxString::Format

static wxString Format(const wxChar *format, ...)

このstatic関数は、(変数とともに) Printfを呼び出した結果を収納した文字列を返す。
This static function returns the string containing the result of calling Printf with the passed parameters on it.

See also

FormatV, Printf


wxString::FormatV

static wxString Format(const wxChar *format, va_list argptr)

このstatic関数は、(変数とともに) PrintfVを呼び出した結果を収納した文字列を返す。
This static function returns the string containing the result of calling PrintfV with the passed parameters on it.

See also

Format, PrintfV


wxString::Freq

int Freq(char ch) const

文字列の中でchが出現した回数を返す。
Returns the number of occurrences of ch in the string.


wxString::GetChar

char GetChar(size_t n) const

nの位置にある文字を返す。(読み込み専用)
Returns the character at position n (read-only).


wxString::GetData

const char* GetData() const

wxWidgets互換性変換。文字列のデータへのconstantポインタを返す。
wxWidgets compatibility conversion. Returns a constant pointer to the data in the string.


wxString::GetWritableChar

char& GetWritableChar(size_t n)

nの位置にある文字への参照を返す。
Returns a reference to the character at position n.


wxString::GetWriteBuf

char* GetWriteBuf(size_t len)

少なくともlenバイト書込み可能なバッファを返す。
Returns a writable buffer of at least len bytes.

文字列を適切な状態にするために、可能な限り早くwxString::UngetWriteBufを呼び出すこと。
Call wxString::UngetWriteBuf as soon as possible to put the string back into a reasonable state.


wxString::Index

size_t Index(char ch) const

wxString::Findと同じである。
Same as wxString::Find.

size_t Index(const char* sz) const

wxString::Findと同じである。
Same as wxString::Find.

size_t Index(const char* sz, bool caseSensitive = TRUE, bool fromEnd = FALSE) const

配列の両端のどちら一方から要素を検索する。
Search the element in the array, starting from either side.

もしfromEndがTRUEならば、逆方向の検索である。
If fromEnd is TRUE, reverse search direction.

もしcaseSensitiveならば、比較は大文字小文字を区別して行われる(指定を省略した時の動作)。
If caseSensitive, comparison is case sensitive (the default).

最初に適合した要素の位置か、wxNOT_FOUNDを返す。
Returns the index of the first item matched, or wxNOT_FOUND.


wxString::IsAscii

bool IsAscii() const

ASCII文字しか含まないならばTRUEを返す。
Returns TRUE if the string contains only ASCII characters.


wxString::IsEmpty

bool IsEmpty() const

文字列が空の時にTRUEを返す。
Returns TRUE if the string is empty.


wxString::IsNull

bool IsNull() const

文字列が空の時にTRUEを返す(IsEmptyと同じ)。
Returns TRUE if the string is empty (same as IsEmpty).


wxString::IsNumber

bool IsNumber() const

文字列が数字(正負記号を含む)の時にTRUEを返す。
Returns TRUE if the string is an integer (with possible sign).


wxString::IsSameAs

bool IsSameAs(const char* psz, bool caseSensitive = TRUE) const

文字列の等価性を、大文字小文字を区別して(省略時)あるいは大文字小文字を区別しないで評価する。
Test for string equality, case-sensitive (default) or not.

caseSensitiveは省略時にTrueになる(大文字小文字に関する事項)
caseSensitive is TRUE by default (case matters).

もし文字列が等しければTRUEを、さもなければFALSEを返す。
Returns TRUE if strings are equal, FALSE otherwise.

CmpCmpNoCaseIsSameAsも参照のこと。
See also Cmp, CmpNoCase, IsSameAs


wxString::IsSameAs

bool IsSameAs(char c, bool caseSensitive = TRUE) const

文字列が単数の文字cと等しいかどうかを評価する。この評価はcaseSensitiveがTRUEならば(省略時)大文字小文字を区別し、もしFALSEならば区別しない。
Test whether the string is equal to the single character c. The test is case-sensitive if caseSensitive is TRUE (default) or not if it is FALSE.

もし文字列が文字と等しければTRUEを、さもなければFALSEを返す。
Returns TRUE if the string is equal to the character, FALSE otherwise.

CmpCmpNoCaseIsSameAsも参照のこと。
See also Cmp, CmpNoCase, IsSameAs


wxString::IsWord

bool IsWord() const

もし文字列が単語ならばTRUEを返す。TODO: 単語はどのような定義にする?
Returns TRUE if the string is a word. TODO: what's the definition of a word?


wxString::Last

char Last() const

最後の文字を 返す。
Returns the last character.

char& Last()

最後の文字への参照を返す(書き込み可能)。
Returns a reference to the last character (writable).


wxString::Left

wxString Left(size_t count) const

文字列のcount番目以降の文字列を返す。
Returns the first count characters of the string.


wxString::Len

size_t Len() const

文字列の長さを返す。
Returns the length of the string.


wxString::Length

size_t Length() const

文字列の長さを返す。(Lenと同じ)
Returns the length of the string (same as Len).


wxString::Lower

wxString Lower() const

この文字列を小文字に変更したもの返す。
Returns this string converted to the lower case.


wxString::LowerCase

void LowerCase()

MakeLowerと同じ
Same as MakeLower.


wxString::MakeLower

void MakeLower()

全ての文字を小文字に変更する。
Converts all characters to lower case.


wxString::MakeUpper

void MakeUpper()

全ての文字を大文字に変更する。
Converts all characters to upper case.


wxString::Matches

bool Matches(const char* szMask) const

もし内容が'*'や'?'を含むszMask文字列に一致するのならばTRUEを返す。
Returns TRUE if the string contents matches a mask containing '*' and '?'.


wxString::Mid

wxString Mid(size_t first, size_t count = wxSTRING_MAXLEN) const

firstからcount文字の長さの、あるいはcountが省略値のときは残り全てで構成される部分文字列を返す。
Returns a substring starting at first, with length count, or the rest of the string if count is the default value.


wxString::Pad

wxString& Pad(size_t count, char pad = ' ', bool fromRight = TRUE)

padcount個複製した文字列を先頭、または末尾(省略値)に追加する。
Adds count copies of pad to the beginning, or to the end of the string (the default).

右から(省略時)でも左からでも空白は削除される
あとで挙動確認します……
Removes spaces from the left or from the right (default).


wxString::Prepend

wxString& Prepend(const wxString& str)

strをこの文字の前にぶら下げ、この文字への参照を返す。
文字列データを共有すると言うことかな? 参照を返しているし。
あとで挙動確認します。
Prepends str to this string, returning a reference to this string.


wxString::Printf

int Printf(const char* pszFormat, ...)

標準関数のsprintf()と似た挙動をする。書き込まれた文字数か、エラーの際は0より小さい数字を返す。
Similar to the standard function sprintf(). Returns the number of characters written, or an integer less than zero on error.

注意:この関数は、正しい大きさのバッファを割り当てることができるときはいつでもvsprintf()の安全版を使用する(通常vsnprintf()が呼ばれる)。不幸にもこの関数が実行環境に存在しないときは、バッファオーバーフローを犯すかもしれない危険なvsprintf()を使用する。
NB: This function will use a safe version of vsprintf() (usually called vsnprintf()) whenever available to always allocate the buffer of correct size. Unfortunately, this function is not available on all platforms and the dangerous vsprintf() will be used then which may lead to buffer overflows.


wxString::PrintfV

int PrintfV(const char* pszFormat, va_list argPtr)

vprintfと似た挙動をする。書き込まれた文字数か、エラーの際は0より小さい数字を返す。
Similar to vprintf. Returns the number of characters written, or an integer less than zero on error.


wxString::Remove

wxString& Remove(size_t pos)

Truncateと同じ。posから最後までのぶぶんを削除する。
Same as Truncate. Removes the portion from pos to the end of the string.

wxString& Remove(size_t pos, size_t len)

文字列のposからlen個の文字を削除する。
Removes the len characters from the string, starting at pos.


wxString::RemoveLast

wxString& RemoveLast()

最後の文字を削除する。
Removes the last character.


wxString::Replace

size_t Replace(const char* szOld, const char* szNew, bool replaceAll = TRUE)

szOldに一致する最初の(または全ての)部分文字列をszNewに置き換える。
Replace first (or all) occurrences of substring with another one.

replaceAll: 全体的な置換(省略値)を行うか、または最初の存在のみを置換するかを指定する。
replaceAll: global replace (default), or only the first occurrence.

置換を行った回数を返す。
Returns the number of replacements made.


wxString::Right

wxString Right(size_t count) const

最後のcount個の文字を返す。
Returns the last count characters.


wxString::SetChar

void SetChar(size_t n, charch)

nの位置に文字chを設置する。
Sets the character at position n.


wxString::Shrink

void Shrink()

文字列の記憶領域を最小化する。Alloc()を呼び出して余分に記憶領域を確保してしまったときに呼び出すと便利である。
Minimizes the string's memory. This can be useful after a call to Alloc() if too much memory were preallocated.


wxString::sprintf

void sprintf(const char* fmt)

Printfと同じ。
The same as Printf.


wxString::StartsWith

bool StartsWith(const wxChar *prefix, wxString *rest = NULL) const

この関数は 文字列が指定されたprefixで始まるかどうかを検査する。もし始まるのならば、この関数はTRUEを返し、また残り(prefixよりも後ろ)の部分がNULLでないのならばrestに代入する。さもなければ、この関数はFALSEを返しrestを変更しない。
This function can be used to test if the string starts with the specified prefix. If it does, the function will return TRUE and put the rest of the string (i.e. after the prefix) into rest string if it is not NULL. Otherwise, the function returns FALSE and doesn't modify the rest.


wxString::Strip

enum stripType {leading = 0x1, trailing = 0x2, both = 0x3};
wxString Strip(stripType s = trailing) const

文字列の前後から空白を取り除いた文字を取り出す。文字列を変更しないことを除いてTrimと同じ。
Strip characters at the front and/or end. The same as Trim except that it doesn't change this string.


wxString::SubString

wxString SubString(size_t from, size_t to) const

非推奨の関数。Midを代わりに使用すること。(ただし、引数が別の意味を持つことに注意すること)
Deprecated, use Mid instead (but note that parameters have different meaning).

fromtoの間の(それ自身を含む)部分文字列を返す。
Returns the part of the string between the indices from and to inclusive.


wxString::ToDouble

bool ToDouble(double *val) const

文字列を浮動小数点数に変換する。変換に成功した場合はTRUEを返し、浮動小数点数はvalで示された変数に保存される。文字列が浮動小数点を表していない場合はFALSEを返す。
Attempts to convert the string to a floating point number. Returns TRUE on success (the number is stored in the location pointed to by val) or FALSE if the string does not represent such number.

See also

wxString::ToLong,
wxString::ToULong


wxString::ToLong

bool ToLong(long *val, int base = 10) const

文字列をbaseで示された進数の符号つき整数に変換する。変換に成功した場合はTRUEを返し、整数はvalで示された変数に保存される。文字列がbaseで示された進数の符号つき整数を表していない場合はFALSEを返す。
Attempts to convert the string to a signed integer in base base. Returns TRUE on success in which case the number is stored in the location pointed to by val or FALSE if the string does not represent a valid number in the given base.

baseの値は2から36の間の数字であるか、Cの整数ルール――もし数字が0xで始まっている場合は16進数を、もし0で始まっている場合は8進数を、さもなければ10進数を意味する――が適用されることを示す特別な値0である必要がある。 もしゼロから始まる数字を構文解析しているのならば、(Cに慣れ親しんでいないユーザーにとって)予期しない結果が発生するので、baseに0を指定するのを望まないだろうことに注意すること。
The value of base must be comprised between 2 and 36, inclusive, or be a special value 0 which means that the usual rules of C numbers are applied: if the number starts with 0x it is considered to be in base 16, if it starts with 0 - in base 8 and in base 10 otherwise. Note that you may not want to specify the base 0 if you are parsing the numbers which may have leading zeroes as they can yield unexpected (to the user not familiar with C) results.

See also

wxString::ToDouble,
wxString::ToULong


wxString::ToULong

bool ToULong(unsigned long *val, int base = 10) const

文字列をbaseで示された進数の符号なし整数に変換する。変換に成功した場合はTRUEを返し、整数はvalで示された変数に保存される。文字列がbaseで示された進数の符号つき整数を表していない場合はFALSEを返す。
Attempts to convert the string to a ansigned integer in base base. Returns TRUE on success in which case the number is stored in the location pointed to by val or FALSE if the string does not represent a valid number in the given base.

base変数の詳細な解説についてはwxString::ToLongを参照のこと。
See wxString::ToLong for the more detailed description of the base parameter.

See also

wxString::ToDouble,
wxString::ToLong


wxString::Trim

wxString& Trim(bool fromRight = TRUE)

左側の空白か、あるいは右側の空白(省略時の値)を削除する。
Removes spaces from the left or from the right (default).


wxString::Truncate

wxString& Truncate(size_t len)

与えられた長さで文字列を切り捨てる。
Truncate the string to the given length.


wxString::UngetWriteBuf

void UngetWriteBuf()

wxString::GetWriteBufが呼び出された後、文字列を適切な状態にする。
Puts the string back into a reasonable state, after wxString::GetWriteBuf was called.


wxString::Upper

wxString Upper() const

大文字に変換した文字列を返す。
Returns this string converted to upper case.


wxString::UpperCase

void UpperCase()

MakeUpperと同じ。
The same as MakeUpper.


wxString::operator!

bool operator!() const

空の文字列はFALSEだが、!stringは文字列が空の場合にTRUEを返す。これにより、const char *のNULL状態と文字列の空状態を同じコードで記述することが出来るようになるため、古いコードをwxStringに置き換えるのが楽になる。
Empty string is FALSE, so !string will only return TRUE if the string is empty. This allows the tests for NULLness of a const char * pointer and emptyness of the string to look the same in the code and makes it easier to port old code to wxString.

IsEmpty()も参照のこと。
See also IsEmpty().


wxString::operator =

wxString& operator =(const wxString& str)

wxString& operator =(const char* psz)

wxString& operator =(char c)

wxString& operator =(const unsigned char* psz)

wxString& operator =(const wchar_t* pwz)

割り当て。 これらの演算の効果はコンストラクタと同じである。(wxString constructorsを参照)
Assignment: the effect of each operation is the same as for the corresponding constructor (see wxString constructors).


wxString::operator +

連結。全ての演算子は演算により合わされた文字列と等しい新しい文字列を返す。
Concatenation: all these operators return a new strign equal to the sum of the operands.

wxString operator +(const wxString& x, const wxString& y)

wxString operator +(const wxString& x, const char* y)

wxString operator +(const wxString& x, char y)

wxString operator +(const char* x, const wxString& y)


wxString::operator +=

void operator +=(const wxString& str)

void operator +=(const char* psz)

void operator +=(char c)

その場での連結。この記述は文字列を追記する。
Concatenation in place: the argument is appended to the string.


wxString::operator []

char& operator [](size_t i)

char operator [](size_t i)

char operator [](int i)

要素抽出。
Element extraction.


wxString::operator ()

wxString operator ()(size_t start, size_t len)

Midと同じ。 (部分文字列の抽出)
Same as Mid (substring extraction).


wxString::operator <<

wxString& operator <<(const wxString& str)

wxString& operator <<(const char* psz)

wxString& operator <<(char ch)

+=と同じ。
Same as +=.

wxString& operator <<(int i)

wxString& operator <<(float f)

wxString& operator <<(double d)

これらの関数はC++のストリームと同じように動作する。与えられた値を文字列に挿入する。 精度や書式は設定できないので、その場合はPrintfを使用すること。
These functions work as C++ stream insertion operators: they insert the given value into the string. Precision or format cannot be set using them, you can use Printf for this.


wxString::operator >>

friend istream& operator >>(istream& is, wxString& str)

ストリームからの抽出
Extraction from a stream.


wxString::operator const char*

operator const char*() const

C文字列への暗黙の変換
Implicit conversion to a C string.


Comparison operators

bool operator ==(const wxString& x, const wxString& y)

bool operator ==(const wxString& x, const char* t)

bool operator !=(const wxString& x, const wxString& y)

bool operator !=(const wxString& x, const char* t)

bool operator >(const wxString& x, const wxString& y)

bool operator >(const wxString& x, const char* t)

bool operator >=(const wxString& x, const wxString& y)

bool operator >=(const wxString& x, const char* t)

bool operator <(const wxString& x, const wxString& y)

bool operator <(const wxString& x, const char* t)

bool operator <=(const wxString& x, const wxString& y)

bool operator <=(const wxString& x, const char* t)

Remarks

これらの比較は大文字小文字を区別する。
These comparisons are case-sensitive.