R言語のstringrパッケージに含まれているstr_sub_all()関数について解説します。この関数は、「1つの文字列(またはベクトルの各要素)から、複数の異なる位置にある文字を、同時にまとめて切り出したい」ときに使える関数です。複数の開始・終了位置をリストやベクトルで指定して、一気に抽出できるのが特徴です。
stringrパッケージは、文字列データを操作するための強力で便利な関数を多く取り扱っています。また、Rのデータサイエンス向け主要パッケージ群であるtidyverseパッケージにも含まれています。
概要
str_sub_all()は、位置を使用して部分文字列を取得するための関数です。
使い方
str_sub_all(string, start = 1L, end = -1L)
引数
文字ベクトルまたは文字ベクトルに変換可能なものを指定します。
抽出する文字の範囲(両端を含む)を定義する整数ベクトルのペアを指定します。
正の値は文字列の左から数え、負の値は右から数えます。つまり、文字列が”abcdef”の場合、1は”a”を、-1は”f”を表します。
あるいは、ベクトルのペアの代わりに、start に行列を渡すこともできます。行列は、startとend、またはstartとlengthというラベルの付いた2つの列を持つ必要があります。これにより、str_sub_all()はstr_locate()などの出力を直接処理します。
単一の論理値を指定します。
TRUEの場合、指定された引数のいずれかに欠損値がある場合は、入力は変更されません。
戻り値
stringと同じ長さのリストを返します。
各要素はstart/endと同じ長さの文字ベクトルです。
endがstartより前にある場合、またはstartがstringの範囲外にある場合、対応する出力は空文字列になります。
使用例
準備
あらかじめ、tidyverseパッケージまたはstringrパッケージを読み込んでおきます。
# library(tidyverse)でもよい
library(stringr)
位置を使用して部分文字列を取得する
文字列「abcde」内で文字列「bcd」を取得するには次のようにします。
str_sub_all("abcde", 2, 4)
[[1]]
[1] "bcd"
2つの文字列「abcde」「あいうえお」のそれぞれに対して、1文字目から2文字目と4文字目から5文字目を取得するには次のようにします。
str_sub_all(c("abcde", "あいうえお"), c(1, 4), c(2, 5))
[[1]]
[1] "ab" "de"
[[2]]
[1] "あい" "えお"