【Java】Stream APIのIntStream.rangeメソッドについて解説します

こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在4社経験している、11年目エンジニアです。

この記事では、 JavaのStream APIのIntStream.rangeメソッドについて

Stream APIのIntStream.rangeメソッドとは
Stream APIのIntStream.rangeメソッドを使ったサンプルプログラム

と、丁寧に解説していきます。

Stream APIについては、こちらの記事をご参考ください。

【Java】Stream APIについて解説します

前提条件：実行環境について
Stream APIのIntStream.rangeメソッドとは
Stream APIのIntStream.rangeメソッドを解説するプログラムの概要
Javaサンプルプログラム
実行結果
まとめ：Stream APIのIntStream.rangeメソッドを使ってみよう！

前提条件：実行環境について

実行環境は以下の通りです。

OS	Windows10
IntelliJ IDEAのエディション	Community(無料版)
IntelliJ IDEAのバージョン	2021.3.2
プロジェクト	Javaプロジェクト
SDK	Oracle OpenJDK version17.0.2

Javaを動かすためにIntelliJ IDEAを使っています。
IntelliJ IDEAのインストールは、下の記事をご参考ください。

【IntelliJ IDEA】インストールするやり方を解説します（Windows向け）

Stream APIのIntStream.rangeメソッドとは

Stream APIのIntStream.rangeメソッドとは、引数で指定した開始値（含む）から上限値（含まない）の範囲で1ずつ増えているIntStreamを返すメソッドです。
IntStream.rangeメソッドは、Streamの生成に分類します。
IntStream.rangeメソッドを使うためには、

import java.util.stream.IntStream;

1	import java.util.stream.IntStream;

をインポートする必要があります。

使い方サンプルは以下になります。

IntStream.range(【開始値】, 【上限値】)
        .【中間操作】
        .【終端操作】;

IntStream.range(【開始値】, 【上限値】)

.【中間操作】

.【終端操作】;

たとえば

IntStream.range(0, 2)

1	IntStream.range(0, 2)

と引数が指定されていた場合

0
1

の要素を持っているIntStreamが返されます。

もし上限値が開始値以上に大きい場合、例外は発生しませんが空のIntStreamが返されます。
引数を指定する順番にはご注意ください。

では、次の章で実際に使ってみます。

Stream APIのIntStream.rangeメソッドを解説するプログラムの概要

Stream APIのIntStream.rangeメソッドを解説するプログラムではIntStream.rangeでIntStreamを作成し要素を表示させます。
指定する引数は

開始値<上限値の場合
開始値>上限値の場合
開始値=上限値の場合

の3パターンでIntStreamを作成し、何の要素が作成されるかを確認します。

解説で使うJavaプログラムは、Sampleプロジェクトのsampleパッケージ内にある、とします。
JavaのStream APIのIntStream.rangeメソッドを解説

Javaサンプルプログラム

package sample;

import java.util.stream.IntStream;

public class Sample {
    public static void main(String[] args) {
        System.out.println("■IntStream.rangeメソッドサンプル");
        System.out.println("・開始値<上限値の場合");
        IntStream.range(1, 6).forEach(num -> System.out.println(num));

        System.out.println("・開始値>上限値の場合");
        IntStream.range(6, 1).forEach(num -> System.out.println(num));

        System.out.println("・開始値=上限値の場合");
        IntStream.range(1, 1).forEach(num -> System.out.println(num));
    }
}

package sample;

import java.util.stream.IntStream;

public class Sample {

public static void main(String[] args) {

System.out.println("■IntStream.rangeメソッドサンプル");

System.out.println("・開始値<上限値の場合");

IntStream.range(1, 6).forEach(num -> System.out.println(num));

System.out.println("・開始値>上限値の場合");

IntStream.range(6, 1).forEach(num -> System.out.println(num));

System.out.println("・開始値=上限値の場合");

IntStream.range(1, 1).forEach(num -> System.out.println(num));

}

forEachメソッドは繰り返し処理を行うメソッドです。
詳しくはこちらの記事をご参考ください。

【Java】Stream APIのforEachメソッドについて解説します

実行結果

Javaプログラムを実行します。
実行のやり方は

プログラムを右クリックして実行
実行タブから実行
ガターから実行

の3種類あるので、いずれかで実行します。
詳しい解説は以下の記事をご参考ください。

【IntelliJ IDEA】引数なしでJavaアプリケーションを実行するやり方を解説します

JavaのStream APIのIntStream.rangeメソッドを解説

■IntStream.rangeメソッドサンプル
・開始値<上限値の場合
1
2
3
4
5
・開始値>上限値の場合
・開始値=上限値の場合

■IntStream.rangeメソッドサンプル

・開始値<上限値の場合

・開始値>上限値の場合

・開始値=上限値の場合

開始値<上限値の場合のみ、IntStreamが作成されていることが確認できました。

まとめ：Stream APIのIntStream.rangeメソッドを使ってみよう！

以上がJavaのStream APIのIntStream.rangeメソッドについての解説でした！

あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ