JavaでreplaceFirstメソッドを使って最初に該当した文字列を置換する方法を現役エンジニアが解説【初心者向け】

初心者向けにJavaでreplaceFirstメソッドを使って最初に該当した文字列を置換する方法について解説しています。replaceFirstは指定した条件で最初に該当した文字列を置き換えることができるメソッドです。正規表現と組み合わせた使い方について、実際の例で見てみましょう。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

JavaでreplaceFirstメソッドを使って最初に該当した文字列を置換する方法について、TechAcademyのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。

Javaについてそもそもよく分からないという方は、Javaとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプ、Java講座の内容をもとに作成しています。

 

田島悠介

今回は、Javaに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

replaceFirstメソッドを使って最初に該当した文字列を置換する方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

replaceFirstメソッドとは

文字列を正規表現で検索し、最初にHITした1件だけ置換するためのメソッドです。

replaceFirstを利用するメリット

replaceFirstと似た機能をもつメソッドとしてreplaceAllがあります。replaceAllは全件検索して一括置換が可能ですが、詳細が不明になってしまいます。

一方で、replaceFirstは、検索してHITした1件ごとに処理が実施できるため、HIT件数をカウントできたり、if文による条件分岐を使ったより詳細なプログラミングをしながら置換処理を実行することができます。

replaceFirstを使うケース

このような場合は、replaceFirstを使うと便利です。

  • 置換件数を把握したい時
  • 1回の置換を実行する度にログ出力をしたい時
1時間でできる無料体験!

replaceFirstメソッドの使い方

replaceFirstは、Stringクラスに実装済みのメソッドとして使うことができます。replaceFirstメソッドの使い方は、以下の通りです。

String sampleStr = "ABC"
String replacedStr = sampleStr.replaceFirst("正規表現”、"置換後の文字列")

 

[PR] Javaプログラミングで挫折しない学習方法を動画で公開中

最初に該当した文字列を置換する方法

テキストエディタで置換処理をする場合とほぼ同じ感覚で置換が可能です。例えば、以下のサンプルプログラムでは、最初に検索条件の「OK」にヒットした箇所を「#」に置換することができます。

public static void main(String[] args) {
  String target1 = "OK1234NG567OK89";
  String afterStr = target1.replaceFirst( "OK", "#" );
  System.out.println( "replaceFirstしました:" + afterStr );
}

実行結果

replaceFirstしました:#1234NG567OK89

上記サンプルでは「OK」という文字列を検索条件に指定しましたが、これは正規表現として扱われます。正規表現については、replaceAllの記事で解説しています。一括置換したい場合も、こちらの記事をご覧ください。

 

実際に書いてみよう

replaceFirstは最初にHITした文字列だけ置換しますが、for文で繰り返し実行することで件数をカウントしながら一括置換をすることもできます。今回は、以下の例文の余計な半角スペースを置換回数をカウントしながら一括置換するプログラムを書いてみましょう。

“Regular    Expression   is very   useful!”

サンプルプログラム

public class ReplaceFirstSample {

  public static void main(String[] args) {
    // 半角スペースが多すぎる例文(置換処理対象)
    String target = "Regular    Expression    is very    useful!" ;
    // 半角スペースが2つ以上連続している場合を検出する正規表現
    String regex = "[ ] {2,}+" ;
 
    int mutchCount = 0;
    for( int i=0 ; i < 100 ; i++ ) {
      // 半角スペースが2つ以上並んでいるケースを半角スペース1つだけに置換する
      target = target.replaceFirst( regex, " " ); // replaceFirst メソッドの実行
      mutchCount = mutchCount + 1 ;
      // 途中経過をコンソールに表示
      System.out.println( mutchCount + "回目HITしました。置換後文字列:" + target );
 
      if( !Pattern.compile(regex).matcher(target).find() ) {
        // 全て置換し終わって target が正規表現にHITしなくなったら処理終了
        break ;
      }
    }
    System.out.println( " === 処理結果 === " );
    System.out.println( " リプレイス回数: " + mutchCount + " 回" );
    System.out.println( " 置換処理後の最終的なテキストは ");
    System.out.println( target + " です。");
  }
}

実行結果

1回目HITしました。置換後文字列:Regular Expression is very useful!
2回目HITしました。置換後文字列:Regular Expression is very useful!
3回目HITしました。置換後文字列:Regular Expression is very useful!
=== 処理結果 ===
リプレイス回数: 3 回
置換処理後の最終的なテキストは
Regular Expression is very useful! です。

 

コラム

実は私も!?独学で損する人の特徴

「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ 独学には向き不向きがあり、実はスクールが向いている人も大勢います。

そんな方のために参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

  • ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
  • ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
  • ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、 スクールが向いているかもしれません。
お試しのつもりで、まずは一度 無料相談 に参加してみませんか?

現役エンジニア・デザイナーに何でも気軽に相談できる30分すべて無料で できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き! 無料相談はこちら

まとめ

replaceFirstメソッドを使うことで、1件の検索・置換を実行することができます。また、for文と組み合わせて使うことで件数をカウントしながらの一括置換も可能です。

 

監修してくれたメンター

寺谷文宏

WEBアプリケーションエンジニアとして数多くのプロジェクトを経験し、フロントエンドからサーバーサイドまで総合的な開発を得意としています。

TechAchademyではフロントエンド、Javaコースを担当。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

TechAcademyでは、初心者でも、JavaやServletの技術を使ってWebアプリケーション開発を習得できる、オンラインブートキャンプを開催しています。

 

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

初心者・未経験でもできる。まずはテックアカデミーに相談しよう

プログラミングを独学していて、このように感じた経験はないでしょうか?

  • ・調べてもほしい情報が見つからない
  • ・独学のスキルが実際の業務で通用するのか不安
  • ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう 厳しい試験を通過した講師 があなたの相談に真摯に向き合います。

「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」

こんな気持ちでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)

今なら参加者限定の割引特典付き! 無料相談を予約する