R×stringr::str_ends 文字列の末尾の一致の有無を検出する

R言語のstringrパッケージに含まれているstr_ends()関数について解説します。この関数は、「文字列が特定のパターン(文字)で終わっているかを判定したい」ときに使える関数です。一言で言えば、ベースRのendsWith()関数のstringr(正規表現対応)版です。

stringrパッケージは、文字列データを操作するための強力で便利な関数を多く取り扱っています。また、Rのデータサイエンス向け主要パッケージ群であるtidyverseパッケージにも含まれています。

概要

str_ends()は、文字列の末尾の一致の有無を検出するための関数です。これは、str_detect()の特殊なケースです。

使い方


str_ends(string, pattern, negate = FALSE)

引数

string

文字ベクトルまたは文字ベクトルに変換可能なものを指定します。

pattern

検索するパターンを指定します。
デフォルトの解釈は、vignette(“regular-expressions”)で説明されている正規表現です。マッチング動作をより細かく制御するには、regex()を使用してください。
fixed()を使用して、固定文字列(つまり、バイトのみを比較する)をマッチングします。これは高速ですが、近似値です。一般的に、人間のテキストをマッチングするには、指定されたロケールの文字マッチング規則を尊重するcoll()が適しています。

negate = FALSE

TRUE の場合、結果の真偽値ベクトルを反転します。

戻り値

真偽値ベクトルを返します。

使用例

準備

あらかじめ、tidyverseパッケージまたはstringrパッケージを読み込んでおきます。


# library(tidyverse)でもよい
library(stringr)

末尾判定

文字列「あいうえおあいう」内で文字列「お」を末尾に含むかどうかを確認するには次のようにします。


str_ends("あいうえお", pattern = "お")

[1] TRUE

次のように、文字列のベクトルとして指定することもできます。


str_ends(c("あいうえお", "かきくけこ"), pattern = "お")

[1]  TRUE FALSE

参考文献