付録(string)

basic_string クラス

[機能]

　　文字列を保持するクラスです．比較演算子による比較や，＋演算子による結合が可能です．

template <class charT, class traits = char_traits<charT>,
class Allocator = allocator<charT>>
    class basic_string

   using string    = basic_string<char>;
   using u8string  = basic_string<char8_t>;   // C++20
   using u16string = basic_string<char16_t>;   // C++11
   using u32string = basic_string<char32_t>;   // C++11
   using wstring   = basic_string<wchar_t>;

[使用方法]　　npos : 無効な位置（static const size_type npos = -1;）

#include <string>
using namespace std;
string 変数名;

[メンバー関数等]

basic_string& append(const basic_string& str)
basic_string& append(const basic_string& str, size_type pos, size_type n)
basic_string& append(const charT* s, size_type n)
basic_string& append(const charT* s)
basic_string& append(size_type n, charT c)
template <class InputIterator> basic_string& append(InputIterator first, InputIterator last)
basic_string& append(initializer_list init) // C++11
指定された文字列，文字，または，初期化子リストを追加する
basic_string& assign(const basic_string& str)
basic_string& assign(const basic_string& str, size_type pos, size_type n)
basic_string& assign(const charT* s, size_type n)
basic_string& assign(const charT* s)
basic_string& assign(size_type n, charT c)
template <class InputIterator> basic_string& append(InputIterator first, InputIterator last)
basic_string& assign(initializer_list init) // C++11
文字列の再代入を行う
reference at(size_type pos)
位置 pos への参照を返す
charT& back() // C++11
末尾要素への参照を返す
iterator begin()
最初の文字を指すイテレータを返す
const charT* c_str()
char* へ変換する
size_type capacity()
メモリを再確保せずに格納できる最大の要素数を返す
const_iterator cbegin() // C++11
文字列の先頭を指す読み取り専用イテレータを返す
const_iterator cend() // C++11
末尾の次を指す読み取り専用イテレータを返す
void clear()
全ての要素を削除する
int compare(const basic_string& str)
int compare(size_type pos1, size_type n1, const basic_string& str)
int compare(size_type pos1, size_type n1, const basic_string& str, size_type pos2, size_type n2 = npos)
int compare(const charT* s)
int compare(size_type pos1, size_type n1, const charT* s)
int compare(size_type pos1, size_type n1, const charT* s, size_type n2)
他の文字列との比較を行う
size_type copy(charT* str, size_type n, size_type pos = 0)
他の文字列に自身の文字列をコピーする（ '\0' は付加されない）
const_reverse_iterator crbegin() // C++11
末尾を指す読み取り専用逆イテレータを返す
const_reverse_iterator crend() // C++11
先頭の前を指す読み取り専用逆イテレータを返す
const charT* data()
char* へ変換する
bool empty()
文字列が空か否かを返す
iterator end()
最後の文字の次を指すイテレータを返す
basic_string& erase(size_type pos = 0, size_type n = size)
iterator erase(const_iterator it)
iterator erase(const_iterator it1, const_iterator it2)
要素を削除する
size_type find(const basic_string& str, size_type pos = 0)
size_type find(const charT* str, size_type pos = 0)
size_type find(const charT* str, size_type pos, size_type n)
位置 pos から後方へ文字列 str（の最初の n 文字）を探す
size_type find(charT c, size_type pos = 0)
位置 pos から後方へ文字 c を探す
size_type find_first_not_of(const charT* str, size_type pos = 0)
size_type find_first_not_of(const basic_string& str, size_type pos = 0)
位置 pos から後方へ文字列 str に含まれない文字を探す
size_type find_first_not_of(const charT* str, size_type pos, size_type n)
位置 pos から後方へ，文字列 str の最初の n 文字に含まれない文字を探す
size_type find_first_not_of(const charT c, size_type pos = 0)
位置 pos から後方へ，文字 c でない文字を探す
size_type find_first_of(const charT* str, size_type pos = 0)
size_type find_first_of(const basic_string& str, size_type pos = 0)
位置 pos から後方へ文字列 str に含まれるいずれかの文字を探す
size_type find_first_of(const charT* str, size_type pos, size_type n)
位置 pos から後方へ，文字列 str の最初の n 文字に含まれるいずれかの文字を探す
size_type find_first_of(charT c, size_type pos = 0)
位置 pos から後方へ文字 c を探す
size_type find_last_not_of(const charT* str, size_type pos = npos)
size_type find_last_not_of(const basic_string& str, size_type pos = npos)
位置 pos から前方へ文字列 str に含まれない文字を探す
size_type find_last_not_of(const charT* str, size_type pos, size_type n)
位置 pos から前方へ，文字列 str の最初の n 文字に含まれない文字を探す
size_type find_last_not_of(const charT c, size_type pos = npos)
位置 pos から前方へ，文字 c でない文字を探す
size_type find_last_of(const charT* str, size_type pos = npos)
size_type find_last_of(const basic_string& str, size_type pos = npos)
位置 pos から前方へ文字列 str に含まれるいずれかの文字を探す
size_type find_last_of(const charT* str, size_type pos, size_type n)
位置 pos から前方へ，文字列 str の最初の n 文字に含まれるいずれかの文字を探す
size_type find_last_of(charT c, size_type pos = npos)
位置 pos から前方へ文字 c を探す
charT& front() // C++11
先頭要素への参照を返す
allocator_type get_allocator()
アロケータを取得する
basic_string& insert(size_type pos1, const basic_string& str)
basic_string& insert(size_type pos1, const basic_string& str, size_type pos2, size_type n)
basic_string& insert(size_type pos, const charT* s, size_type n)
basic_string& insert(size_type pos, const charT* s)
basic_string& insert(size_type pos, size_type n, charT c)
iterator insert(iterator p, charT c)
basic_string& insert(iterator p, size_type n, charT c)
template <class InputIterator> void insert(iterator p, InputIterator first, InputIterator last)
template <class InputIterator> iterator insert(const_iterator p, InputIterator first, InputIterator last) // C++11
iterator insert(const_iterator p, initializer_list init) // C++11
文字／文字列を挿入する
size_type length()
文字列の長さを返す
size_type max_size()
格納可能な最大の文字列長を返す
void pop_back() // C++11
末尾の1要素を削除する
void push_back(charT c)
末尾に要素を追加する
reverse_iterator rbegin()
末尾を指す逆イテレータを返す
reverse_iterator rend()
先頭の前を指す逆イテレータを返す
basic_string& replace(size_type pos1, size_type n1, const basic_string& str)
basic_string& replace(size_type pos1, size_type n1, const basic_string& str, size_type pos2 = 0, size_type n2 = size)
basic_string& replace(size_type pos, size_type n1, const charT* s, size_type n2)
basic_string& replace(size_type pos, size_type n1, const charT* s)
basic_string& replace(size_type pos, size_type n1, size_type n2, charT c)
basic_string& replace(iterator it1, iterator it2, const basic_string& str)
basic_string& replace(iterator i1, iterator i2, const charT* s, size_type n)
basic_string& replace(iterator it1, iterator it2, size_type n, charT c)
template <class InputIterator> basic_string& replace(iterator it1, iterator it2, InputIterator j1, InputIterator j2) // C++11
basic_string& replace(const_iterator i1, const_iterator i2, initializer_list il) // C++11
文字列の一部を置換する
void resize(size_type n, charT c)
void resize(size_type n)
n <= size() のときは，元の文字列の先頭 n 文字をコピーした文字列で置き換える．また，n > size() のときは，先頭 n 文字は元の文字列のコピー，残りは文字 c を並べた文字列で置き換えられる．なお，resize(n) は， resize(n, charT()) と等しい．
size_type rfind(const charT* str, size_type pos = npos)
size_type rfind(const basic_string& str, size_type pos = npos)
位置 pos から前方へ文字列 str を探す
size_type rfind(const charT* str, size_type pos, size_type n)
位置 pos から前方へ文字列 str の最初の n 文字を探す
size_type rfind(charT c, size_type pos = npos)
位置 pos から前方へ文字列 c を探す
size_type shrink_to_fit() // C++11
領域をコンテナのサイズ size() まで切り詰める
size_type size()
文字列の長さを返す
basic_string substr(size_type pos = 0, size_type n = size)
位置 pos から n 個の文字を取り出す
void swap(basic_string& str)
文字列 s とその内容を入れ替える

[文字列，数値間の変換]

int stoi(const string& str, size_t* idx = nullptr, int base = 10)
文字列 str を数値として読み取って，int 型の値に変換する
long stol(const string& str, size_t* idx = nullptr, long base = 10)
文字列 str を数値として読み取って，long 型の値に変換する
unsigned long stoul(const string& str, size_t* idx = nullptr, unsigned long base = 10)
文字列 str を数値として読み取って，unsigned long 型の値に変換する
long long stoll(const string& str, size_t* idx = nullptr, long long base = 10)
文字列 str を数値として読み取って，long long 型の値に変換する
unsigned long long stoull(const string& str, size_t* idx = nullptr, unsigned long long base = 10)
文字列 str を数値として読み取って，long long 型の値に変換する
float stof(const string& str, size_t* idx = nullptr)
文字列 str を数値として読み取って，float 型の値に変換する
double stod(const string& str, size_t* idx = nullptr)
文字列 str を数値として読み取って，double 型の値に変換する
long double stold(const string& str, size_t* idx = nullptr)
文字列 str を数値として読み取って，long double 型の値に変換する
string to_string(int val)
string to_string(unsigned int val)
string to_string(long val)
string to_string(unsigned long val)
string to_string(long long val)
string to_string(unsigned long long val)
string to_string(float val)
string to_string(double val)
string to_string(long double val)
数値valをstring型文字列に変換する

[演算子の多重定義]

=  +  +=  ==  !=  <  <=  >  >=  <<  >>  []

[使用例]

string の使用方法です．

#include <iostream>
#include <string>

using namespace std;

int main()
{
	char str[10];
	string str1 = "abcde";
	string str2 = str1, str3 = "bcdef";
	string::iterator it1, it2;
					// 文字列のコピー
	str1.copy(str, 3, 2);
	str[3] = '\0';
	cout << "コピーされた結果　" << str << endl;
					// 文字列の比較
	cout << "比較  str1 = " << str1 << ", str2 = " << str2 << ", str3 = " << str3 << endl;
	if (str2 == str1)
		cout << "   str2 == str1\n";
	if (str2 <= str2)
		cout << "   str2 <= str3\n";
					// 文字列の結合
	str1 += (" " + str2);
	cout << "文字列の結合結果： " << str1 << endl;
					// 部分文字列
	cout << str1 << " の 4 文字目から 5 文字\n";
	cout << "   " << str1.substr(3, 5) << endl;
	cout << "   ";
	for (int i1 = 3; i1 < 8; i1++)
		cout << str1[i1];
	cout << endl;
	cout << "   ";
	for (int i1 = 3; i1 < 8; i1++)
		cout << str1.at(i1);
	cout << endl;
	const char *c_str = str1.c_str();
	cout << "   ";
	for (int i1 = 3; i1 < 8; i1++)
		cout << c_str[i1];
	cout << endl;
					// 検索
	cout << str1 << " から文字列 cd の検索結果： " << str1.find("cd") << endl;
					// 挿入
	cout << "挿入（元の文字列： " << str1 << "）\n";
	str2 = "-+*+-";
	str3 = str1;
	cout << "   " << str3.insert(2, str2, 0, 3) << endl;
	str3 = str1;
	it1  = str3.begin() + 2;
	str3.insert(it1, 3, '*');
	cout << "   " << str3 << endl;
					// 削除
	cout << "削除（元の文字列： " << str1 << "）\n";
	str3 = str1;
	cout << "   " << str3.erase(2, 3) << endl;
	str3 = str1;
	it1  = str3.begin() + 2;
	it2  = it1 + 3;
	str3.erase(it1, it2);
	cout << "   " << str3 << endl;
					// 置換
	cout << "置換（元の文字列： " << str1 << "）\n";
	str2 = "-+*+-";
	str3 = str1;
	cout << "   " << str3.replace(3, 5, str2, 0, 3) << endl;
	str3 = str1;
	it1  = str3.begin() + 3;
	it2  = it1 + 5;
	cout << "   " << str3.replace(it1, it2, str2) << endl;
					// 交換
	cout << "交換\n";
	str2 = "-+*+-";
	cout << "   " << str1 << "     " << str2 << endl;
	str1.swap(str2);
	cout << "   " << str1 << "     " << str2 << endl;

	return 0;
}

（出力）

コピーされた結果　cde
比較  str1 = abcde, str2 = abcde, str3 = bcdef
   str2 == str1
   str2 <= str3
文字列の結合結果： abcde abcde
abcde abcde の 4 文字目から 5 文字
   de ab
   de ab
   de ab
   de ab
abcde abcde から文字列 cd の検索結果： 2
挿入（元の文字列： abcde abcde）
   ab-+*cde abcde
   ab***cde abcde
削除（元の文字列： abcde abcde）
   ab abcde
   ab abcde
置換（元の文字列： abcde abcde）
   abc-+*cde
   abc-+*+-cde
交換
   abcde abcde     -+*+-
   -+*+-     abcde abcde

文字列，数値間の変換例です．

#include <iostream>
#include <string>

using namespace std;

int main()
{
	cout << "stoi \"120\" to " << stoi("120") << endl;
	cout << "stod \"3.141592654\" to " << stod("3.141592654") << endl;
	cout << "to_string 120 \"" << to_string(120) << "\" 3.141592654 \"" << to_string(3.141592654) << "\"\n";

	return 0;
}

（出力）

stoi "120" to 120
stod "3.141592654" to 3.14159
to_string 120 "120" 3.141592654 "3.141593"