文字列

[C++] string::substr()の使い方 – 文字列の一部を切り取る

C++のstring::substr()は、文字列から指定した範囲の部分文字列を取得するためのメンバ関数です。

構文はstr.substr(pos, len)で、posは切り取り開始位置(0から始まるインデックス)、lenは切り取る長さを指定します。

lenを省略すると、posから末尾までの文字列が返されます。

範囲外のposを指定すると例外が発生します。

目次から探す

string::substr()とは

string::substr()は、C++の標準ライブラリである<string>ヘッダに含まれるメンバ関数で、文字列の一部を切り取るために使用されます。

この関数を使うことで、指定した位置から指定した長さの部分文字列を取得することができます。

基本的な構文

string substr(size_t pos = 0, size_t len = npos) const;

pos: 切り取りを開始する位置(0から始まるインデックス)
len: 切り取る文字数(省略した場合は、posから文字列の終わりまで)

この関数は、部分文字列を新しいstringオブジェクトとして返します。

posが文字列の長さを超える場合や、lenが無効な場合は、空の文字列が返されます。

以下は、string::substr()を使用して文字列の一部を切り取るサンプルコードです。

#include <iostream>
#include <string>
int main() {
    std::string text = "Hello, World!"; // 元の文字列
    std::string part = text.substr(7, 3); // 7文字目から3文字を切り取る
    std::cout << "切り取った部分: " << part
              << std::endl; // 切り取った部分を表示
    return 0;
}

切り取った部分: Wor

この例では、元の文字列「こんにちは、世界！」から、5文字目から3文字を切り取っています。

結果として「、世」が得られます。

string::substr()は、文字列操作を簡単に行うための便利な関数です。

substr()の基本的な使い方

string::substr()を使用する際の基本的な使い方について詳しく解説します。

この関数は、文字列から特定の部分を切り取るために非常に便利です。

以下に、基本的な使い方を示します。

1. 基本的な構文

substr()の基本的な構文は以下の通りです。

string substr(size_t pos = 0, size_t len = npos) const;

pos: 切り取りを開始する位置(0から始まるインデックス)
len: 切り取る文字数(省略した場合は、posから文字列の終わりまで)

2. 例：基本的な使用法

以下のサンプルコードでは、substr()を使って文字列の一部を切り取る基本的な例を示します。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++プログラミング"; // 元の文字列
    std::string part = text.substr(0, 3); // 0文字目から3文字を切り取る
    std::cout << "切り取った部分: " << part << std::endl; // 切り取った部分を表示
    return 0;
}

切り取った部分: C++

この例では、元の文字列「C++プログラミング」から、0文字目から3文字を切り取っています。

結果として「C++プ」が得られます。

3. 省略引数の使用

lenを省略した場合、posから文字列の終わりまでが切り取られます。

以下の例を見てみましょう。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++プログラミング"; // 元の文字列
    std::string part = text.substr(3); // 3文字目から最後まで切り取る
    std::cout << "切り取った部分: " << part << std::endl; // 切り取った部分を表示
    return 0;
}

切り取った部分: プログラミング

この例では、3文字目から文字列の終わりまでを切り取っています。

結果として「プログラミング」が得られます。

4. 注意点

posが文字列の長さを超える場合、空の文字列が返されます。
lenが指定された場合でも、posから文字列の終わりを超える場合は、実際に切り取られる文字数は、posからの残りの文字数になります。

このように、string::substr()は非常にシンプルで使いやすい関数です。

文字列の一部を簡単に取得できるため、さまざまな場面で活用できます。

substr()の実用例

string::substr()は、文字列の一部を切り取るための便利な関数です。

ここでは、実際のプログラミングシナリオでの使用例をいくつか紹介します。

これにより、substr()の実用性を理解しやすくなります。

1. ファイル名の取得

ファイルパスからファイル名を取得する場合にsubstr()を使用できます。

以下の例では、ファイルパスから拡張子を除いたファイル名を取得します。

#include <iostream>
#include <string>
int main() {
    std::string filePath = "/home/user/document.txt"; // ファイルパス
    size_t pos = filePath.find_last_of("/"); // 最後のスラッシュの位置を取得
    std::string fileName = filePath.substr(pos + 1); // スラッシュの次から切り取る
    std::cout << "ファイル名: " << fileName << std::endl; // ファイル名を表示
    return 0;
}

ファイル名: document.txt

この例では、find_last_of()を使って最後のスラッシュの位置を見つけ、その位置からファイル名を切り取っています。

2. 日付のフォーマット

日付文字列から特定の部分を切り取る場合にもsubstr()が役立ちます。

以下の例では、日付文字列から年、月、日を取得します。

#include <iostream>
#include <string>
int main() {
    std::string date = "2023-10-15"; // 日付文字列
    std::string year = date.substr(0, 4); // 年を取得
    std::string month = date.substr(5, 2); // 月を取得
    std::string day = date.substr(8, 2); // 日を取得
    std::cout << "年: " << year << ", 月: " << month << ", 日: " << day << std::endl; // 日付を表示
    return 0;
}

年: 2023, 月: 10, 日: 15

この例では、日付文字列から年、月、日をそれぞれ切り取っています。

3. テキスト処理

テキストデータから特定の情報を抽出する際にもsubstr()が役立ちます。

以下の例では、テキストから特定のキーワードを含む部分を切り取ります。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++は強力なプログラミング言語です。"; // テキスト
    size_t startPos = text.find("強力"); // キーワードの位置を取得
    std::string keywordPart = text.substr(startPos, 10); // キーワードから10バイトを切り取る
    std::cout << "切り取った部分: " << keywordPart << std::endl; // 切り取った部分を表示
    return 0;
}

切り取った部分: 強力なプロ

この例では、「強力」というキーワードから始まる部分を切り取っています。

4. ユーザー入力の処理

ユーザーからの入力を処理する際にもsubstr()が役立ちます。

以下の例では、ユーザーが入力した文字列から特定の部分を切り取ります。

#include <iostream>
#include <string>
int main() {
    std::string input; // ユーザー入力用の文字列
    std::cout << "文字列を入力してください: ";
    std::getline(std::cin, input); // ユーザーからの入力を取得
    std::string part = input.substr(0, 5); // 最初の5文字を切り取る
    std::cout << "最初の5文字: " << part << std::endl; // 切り取った部分を表示
    return 0;
}

文字列を入力してください: Hello World!
最初の5文字: Hello

この例では、ユーザーが入力した文字列の最初の5文字を切り取っています。

これらの実用例を通じて、string::substr()がどのように役立つかを理解できるでしょう。

文字列操作のさまざまな場面で活用できる便利な関数です。

substr()のエラーと注意点

string::substr()を使用する際には、いくつかのエラーや注意点があります。

これらを理解しておくことで、予期しない動作を避け、より安全にプログラムを作成することができます。

以下に、主なエラーと注意点を示します。

1. posの範囲外アクセス

pos引数に指定した値が、文字列の長さを超えている場合、substr()は空の文字列を返します。

これは、プログラムのロジックに影響を与える可能性があります。

#include <iostream>
#include <string>
int main() {
    std::string text = "こんにちは"; // 元の文字列
    std::string part = text.substr(10); // posが範囲外
    std::cout << "切り取った部分: '" << part << "'" << std::endl; // 空の文字列が表示される
    return 0;
}

切り取った部分: ''

この例では、posが文字列の長さを超えているため、空の文字列が返されています。

2. lenの指定に注意

len引数を指定した場合でも、posからの残りの文字数がlenより少ない場合、実際に切り取られる文字数は残りの文字数になります。

これにより、意図しない結果を招くことがあります。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++プログラミング"; // 元の文字列
    std::string part = text.substr(5, 10); // lenが大きいが、実際には残りの文字数が少ない
    std::cout << "切り取った部分: " << part << std::endl; // 残りの文字数が表示される
    return 0;
}

切り取った部分: ログラミン

この例では、lenが10ですが、posからの残りの文字数は「プログラミング」の部分だけです。

3. 文字列の変更に注意

substr()は元の文字列を変更しませんが、切り取った部分を新しいstringオブジェクトとして返します。

これにより、メモリの使用量が増加する可能性があります。

特に大きな文字列を頻繁に切り取る場合は、パフォーマンスに影響を与えることがあります。

4. Unicode文字の扱い

C++のstringはバイト列として扱われるため、UTF-8エンコーディングの文字列を扱う際には注意が必要です。

特に、マルチバイト文字(例：日本語の漢字など)を切り取る場合、posやlenの指定がバイト単位であるため、意図しない文字が切り取られることがあります。

#include <iostream>
#include <string>
int main() {
    std::string text = "Everyone"; // UTF-8エンコーディングの文字列
    std::string part = text.substr(3, 2); // バイト単位で指定
    std::cout << "切り取った部分: " << part
              << std::endl; // 意図しない結果になる可能性がある
    return 0;
}

切り取った部分: ry

この例では、posやlenがバイト単位で指定されているため、意図しない部分が切り取られる可能性があります。

UTF-8文字列を扱う際は、文字単位での操作を考慮する必要があります。

5. エラーハンドリング

substr()は、エラーをスローすることはありませんが、空の文字列が返される場合があるため、プログラム内でその結果を適切に処理することが重要です。

特に、切り取った部分が空である場合の処理を考慮しておくと良いでしょう。

これらの注意点を理解し、適切に対処することで、string::substr()を安全に活用することができます。

substr()と他の文字列操作関数の比較

C++のstringクラスには、文字列を操作するためのさまざまな関数が用意されています。

ここでは、substr()と他の主要な文字列操作関数を比較し、それぞれの特徴や使い方を解説します。

1. substr() vs find()

関数名	機能	使用例
`substr()`	文字列の一部を切り取る	`text.substr(0, 5)`
`find()`	指定した文字列が最初に現れる位置を返す	`text.find("プログラミング")`

substr()は文字列の一部を取得するのに対し、find()は特定の文字列の位置を見つけるために使用されます。

find()は見つからない場合にstd::string::nposを返すため、位置を確認する際に便利です。

2. substr() vs replace()

関数名	機能	使用例
`substr()`	文字列の一部を切り取る	`text.substr(0, 5)`
`replace()`	指定した位置の文字列を置き換える	`text.replace(0, 5, "C++")`

replace()は指定した位置の文字列を別の文字列に置き換えるために使用されます。

これにより、文字列の一部を変更することができます。

substr()は切り取るだけですが、replace()は内容を変更します。

3. substr() vs append()

関数名	機能	使用例
`substr()`	文字列の一部を切り取る	`text.substr(0, 5)`
`append()`	文字列の末尾に別の文字列を追加する	`text.append(" 追加部分")`

append()は文字列の末尾に新しい文字列を追加するために使用されます。

substr()は文字列の一部を取得するのに対し、append()は文字列を拡張するために使われます。

4. substr() vs erase()

関数名	機能	使用例
`substr()`	文字列の一部を切り取る	`text.substr(0, 5)`
`erase()`	指定した位置から文字列を削除する	`text.erase(0, 5)`

erase()は指定した位置から文字列を削除するために使用されます。

これにより、文字列の一部を削除することができます。

substr()は切り取るだけで、元の文字列は変更されませんが、erase()は元の文字列を直接変更します。

5. substr() vs c_str()

関数名	機能	使用例
`substr()`	文字列の一部を切り取る	`text.substr(0, 5)`
`c_str()`	文字列をCスタイルの文字列に変換する	`text.c_str()`

c_str()はstd::stringをCスタイルの文字列const char*に変換するために使用されます。

これにより、C言語の関数と連携する際に便利です。

substr()は文字列の一部を取得するために使用されますが、c_str()は文字列の形式を変換します。

substr()は文字列の一部を切り取るための便利な関数ですが、他の文字列操作関数と組み合わせて使用することで、より複雑な文字列操作を実現できます。

それぞれの関数の特性を理解し、適切な場面で使い分けることが重要です。

応用的な使い方

string::substr()は基本的な文字列操作だけでなく、さまざまな応用的な使い方が可能です。

ここでは、実際のプログラミングシナリオでの応用例をいくつか紹介します。

これにより、substr()の柔軟性と有用性を理解できるでしょう。

1. CSVファイルの解析

CSV(カンマ区切り値)ファイルから特定のフィールドを抽出する際にsubstr()を使用できます。

以下の例では、カンマで区切られた文字列から特定のフィールドを取得します。

#include <iostream>
#include <string>
int main() {
    std::string csvLine = "Taro,25,Tokyo";   // CSV形式の文字列
    std::string name = csvLine.substr(0, 4); // 名前を取得
    std::string age = csvLine.substr(5, 2);  // 年齢を取得
    std::string city = csvLine.substr(8);    // 都市を取得
    std::cout << "名前: " << name << ", 年齢: " << age << ", 都市: " << city
              << std::endl; // 結果を表示
    return 0;
}

名前: Taro, 年齢: 25, 都市: Tokyo

この例では、CSV形式の文字列から名前、年齢、都市をそれぞれ切り取っています。

2. URLの解析

URLから特定の部分を切り取る際にもsubstr()が役立ちます。

以下の例では、URLからドメイン名を取得します。

#include <iostream>
#include <string>
int main() {
    std::string url = "https://www.example.com/path/to/resource"; // URL
    size_t start = url.find("://") + 3; // "://"の後の位置を取得
    size_t end = url.find("/", start); // 次のスラッシュの位置を取得
    std::string domain = url.substr(start, end - start); // ドメイン名を切り取る
    std::cout << "ドメイン名: " << domain << std::endl; // ドメイン名を表示
    return 0;
}

ドメイン名: www.example.com

この例では、URLからドメイン名を切り取っています。

3. テキストのトリミング

文字列の前後の空白を削除するためにsubstr()を使用することもできます。

以下の例では、テキストの前後の空白をトリミングします。

#include <iostream>
#include <string>
#include <algorithm> // std::find_if
int main() {
    std::string text = "   C++プログラミング   "; // 前後に空白がある文字列
    size_t start = text.find_first_not_of(" "); // 最初の非空白文字の位置を取得
    size_t end = text.find_last_not_of(" "); // 最後の非空白文字の位置を取得
    std::string trimmed = text.substr(start, end - start + 1); // トリミングした文字列を取得
    std::cout << "トリミング後: '" << trimmed << "'" << std::endl; // トリミング後の文字列を表示
    return 0;
}

トリミング後: 'C++プログラミング'

この例では、前後の空白を削除した文字列を取得しています。

4. 文字列の分割

substr()を使って文字列を分割することも可能です。

以下の例では、スペースで区切られた文字列を分割します。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++ プログラミング は 楽しい"; // スペースで区切られた文字列
    size_t pos = 0;
    size_t nextPos = 0;
    while ((nextPos = text.find(" ", pos)) != std::string::npos) {
        std::string word = text.substr(pos, nextPos - pos); // 単語を切り取る
        std::cout << "単語: " << word << std::endl; // 単語を表示
        pos = nextPos + 1; // 次の位置に移動
    }
    // 最後の単語を取得
    std::string lastWord = text.substr(pos);
    std::cout << "単語: " << lastWord << std::endl; // 最後の単語を表示
    return 0;
}

単語: C++
単語: プログラミング
単語: は
単語: 楽しい

この例では、スペースで区切られた文字列を分割し、各単語を表示しています。

5. 文字列の置換と組み合わせ

substr()を他の文字列操作関数と組み合わせて、より複雑な操作を行うこともできます。

以下の例では、特定の部分を切り取って置き換えます。

#include <iostream>
#include <string>
int main() {
    std::string text = "C++プログラミングは楽しい"; // 元の文字列
    std::string part = text.substr(0, 3); // 最初の3文字を切り取る
    text.replace(0, 3, "Java"); // 切り取った部分を置き換える
    std::cout << "置き換え後: " << text << std::endl; // 置き換え後の文字列を表示
    return 0;
}

置き換え後: Javaプログラミングは楽しい

この例では、最初の3文字を切り取って Java に置き換えています。

これらの応用例を通じて、string::substr()の多様な使い方を理解し、実際のプログラミングに役立てることができるでしょう。

substr()は、他の文字列操作関数と組み合わせることで、より強力な文字列処理を実現します。

まとめ

この記事では、C++のstring::substr()関数の基本的な使い方から応用的な利用方法までを詳しく解説しました。

substr()は文字列の一部を切り取るための非常に便利な関数であり、他の文字列操作関数と組み合わせることで、さまざまな文字列処理を実現できます。

これを機に、実際のプログラムでsubstr()を活用し、より効率的な文字列操作を行ってみてください。