R×stringr::str_sub_all 位置を使用して部分文字列を取得する

R言語のstringrパッケージに含まれているstr_sub_all()関数について解説します。この関数は、「1つの文字列(またはベクトルの各要素)から、複数の異なる位置にある文字を、同時にまとめて切り出したい」ときに使える関数です。複数の開始・終了位置をリストやベクトルで指定して、一気に抽出できるのが特徴です。

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

概要

str_sub_all()は、位置を使用して部分文字列を取得するための関数です。

使い方


str_sub_all(string, start = 1L, end = -1L)

引数

string

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

start, end

抽出する文字の範囲(両端を含む)を定義する整数ベクトルのペアを指定します。
正の値は文字列の左から数え、負の値は右から数えます。つまり、文字列が”abcdef”の場合、1は”a”を、-1は”f”を表します。
あるいは、ベクトルのペアの代わりに、start に行列を渡すこともできます。行列は、startとend、またはstartとlengthというラベルの付いた2つの列を持つ必要があります。これにより、str_sub_all()はstr_locate()などの出力を直接処理します。

omit_na = FALSE

単一の論理値を指定します。
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] "あい" "えお"

参考文献