Redis GETRANGEコマンドの使い方 – 文字列値から部分文字列を取得する方法

このチュートリアルでは、Redisデータストア内の指定したキーに保存された文字列値の部分文字列（サブストリング）を取得する方法を解説します。この操作には、RedisのGETRANGEコマンドを使用します。

GETRANGEコマンドとは

GETRANGEコマンドは、start（開始位置・範囲に含まれる）とend（終了位置・範囲に含まれる）という2つのオフセットを受け取り、取得する部分文字列の開始インデックスと終了インデックスを指定します。

インデックスは0ベースで、0が最初の文字、1が2番目の文字を表します。また、負の数値を使うことで、文字列の末尾からのオフセットも指定できます。-1は最後の文字、-2は最後から2番目の文字となります。

指定したオフセットが文字列の実際の長さを超えている場合（範囲外の場合）、結果の範囲は自動的に文字列の実際の長さに制限されるため、エラーは発生しません。

構文

redis host:post> GETRANGE <キー名> <start> <end>

出力

(string) 文字列値から切り出された部分文字列が返されます。

使用例

補足：GETRANGEとSUBSTRの関係

GETRANGEは、旧バージョンのRedis 2.0まで存在していたSUBSTRコマンドの改名版です。既存のコードとの互換性のためSUBSTRも引き続き利用できますが、新規開発ではGETRANGEの使用が推奨されています。

参考資料

1. GETRANGEコマンド公式ドキュメント

以上が、Redisデータストアに保存された文字列値から部分文字列を取得する方法でした。この記事が役に立った場合は、ぜひコメント欄でご意見をお聞かせください。また、他の方にもシェアしていただけると嬉しいです。

<- 文字列コマンド一覧へ戻る