最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

split

string の string 配列への分割

構文

newStr = split(str)

newStr = split(str,delimiter)

newStr = split(str,delimiter,dim)

[newStr,matches] = split(___)

説明

newStr = split(str) は str を空白文字の位置で分割し、結果を出力配列 newStr として返します。入力配列 str には、string 配列、文字ベクトル、文字ベクトルの cell 配列を指定できます。str が string 配列の場合、newStr も string 配列です。それ以外の場合、newStr は文字ベクトルの cell 配列です。newStr には str の空白文字は含まれません。

str に複数の要素が含まれる場合、各要素は同じ数の部分文字列に分割可能でなければなりません。

• str が string スカラーまたは文字ベクトルの場合、newStr は N 行 1 列の string 配列または文字ベクトルの cell 配列 (N は部分文字列の数) です。

• str が M 行 1 列の string 配列または cell 配列の場合、newStr は M 行 N 列の配列となります。

• str が 1 行 M 列の string 配列または cell 配列の場合、newStr は 1 x M x N の配列となります。

任意のサイズの string 配列または cell 配列について、split は N 個の部分文字列を、サイズが 1 である最初の後続次元に沿って配置します。

str のすべての要素で部分文字列の数が同じではない場合、for ループで split を呼び出して、str の要素を一度に 1 つずつ分割します。

newStr = split(str,delimiter) は、delimiter で指定した区切り記号で str の各要素を分割します。出力 newStr は区切り記号を含みません。

newStr = split(str,delimiter,dim) は、str の各要素を dim で指定された次元に沿ってベクトルに分割します。

[newStr,matches] = split(___) は、配列 matches も返します。これには関数 split が str を分割する区切り記号のすべての出現箇所が含まれます。この構文では、前述の構文の入力引数のいずれかを使用できます。

例

string を空白の位置で分割し、再結合

string 配列内の名前を空白文字の位置で分割します。姓が名の前になるように、string を並べ替えてから結合します。

名前を含む 3 行 1 列の string 配列を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

names = ["Mary Butler";
         "Santiago Marquez";
         "Diana Lee"]

names = 3x1 string array
    "Mary Butler"
    "Santiago Marquez"
    "Diana Lee"

names を空白文字の位置で分割し、3 行 2 列の string 配列にします。

names = split(names)

names = 3x2 string array
    "Mary"        "Butler" 
    "Santiago"    "Marquez"
    "Diana"       "Lee"    

姓が最初の列になるように、names の列を切り替えます。それぞれの姓の後にコンマを追加します。

names = [names(:,2) names(:,1)];
names(:,1) = names(:,1) + ','

names = 3x2 string array
    "Butler,"     "Mary"    
    "Marquez,"    "Santiago"
    "Lee,"        "Diana"   

姓と名を結合します。関数 join は、結合する string の間に空白文字を配置します。結合後、names は 3 行 1 列の string 配列になります。

names = join(names)

names = 3x1 string array
    "Butler, Mary"
    "Marquez, Santiago"
    "Lee, Diana"

string を区切り記号の位置で分割し、新しい区切り記号で再結合

フォルダーのパスを含む string を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

myPath = "/Users/jdoe/My Documents/Examples"

myPath = 
"/Users/jdoe/My Documents/Examples"

パスを / 文字の位置で分割します。split は myFolders を 5 行 1 列の string 配列として返します。最初の string は "" です。これは、myPath が / 文字で始まるためです。

myFolders = split(myPath,"/")

myFolders = 5x1 string array
    ""
    "Users"
    "jdoe"
    "My Documents"
    "Examples"

\ を区切り記号として myFolders を新しいパスに結合します。パスの始めとして C: を追加します。

myNewPath = join(myFolders,"\");
myNewPath = 'C:' + myNewPath

myNewPath = 
"C:\Users\jdoe\My Documents\Examples"

string を複数の区切り記号の位置で分割

string を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

str = "A horse! A horse! My kingdom for a horse!"

str = 
"A horse! A horse! My kingdom for a horse!"

str を感嘆符と空白文字の位置で分割します。newStr は 10 行 1 列の string 配列です。最後の string は空の string "" です。これは、str の最後の文字が区切り記号であるためです。

newStr = split(str,[" ","!"])

newStr = 12x1 string array
    "A"
    "horse"
    ""
    "A"
    "horse"
    ""
    "My"
    "kingdom"
    "for"
    "a"
    "horse"
    ""

string 配列を区切り記号間にある欠損データの位置で分割

患者に関するコンマ区切りのデータが各要素に含まれる string 配列を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

patients = ["LastName,Age,Gender,Height,Weight";
            "Adams,47,F,64,123";
            "Jones,,,68,175";
            "King,,M,66,180";
            "Smith,38,F,63,118"]

patients = 5x1 string array
    "LastName,Age,Gender,Height,Weight"
    "Adams,47,F,64,123"
    "Jones,,,68,175"
    "King,,M,66,180"
    "Smith,38,F,63,118"

string 配列を分割します。間に何もないコンマのペアは欠損データを示します。split が区切り記号の繰り返し位置で分割を行うと、出力配列の対応する要素に空の string が返されます。

patients = split(patients,",")

patients = 5x5 string array
    "LastName"    "Age"    "Gender"    "Height"    "Weight"
    "Adams"       "47"     "F"         "64"        "123"   
    "Jones"       ""       ""          "68"        "175"   
    "King"        ""       "M"         "66"        "180"   
    "Smith"       "38"     "F"         "63"        "118"   

string を指定した次元に沿って配置

名前を含む 3 行 1 列の string 配列を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

names = ["Mary Butler";
         "Santiago Marquez";
         "Diana Lee"]

names = 3x1 string array
    "Mary Butler"
    "Santiago Marquez"
    "Diana Lee"

配列を空白文字の位置で分割します。既定では、split は出力部分文字列をサイズが 1 である最初の後続次元に沿って配置します。names は 3 行 1 列の string 配列なので、split は部分文字列を splitNames の 2 番目の次元 (つまり列) に沿って配置します。

splitNames = split(names)

splitNames = 3x2 string array
    "Mary"        "Butler" 
    "Santiago"    "Marquez"
    "Diana"       "Lee"    

部分文字列を行 (つまり最初の次元) に沿って配置するには、区切り記号を指定した後で次元を指定します。splitNames が 2 行 3 列の string 配列になり、1 行目に名、2 行目に姓が含まれます。

splitNames = split(names," ",1)

splitNames = 2x3 string array
    "Mary"      "Santiago"    "Diana"
    "Butler"    "Marquez"     "Lee"  

string を分割して区切り記号を返す

string を作成します。R2017a 以降、二重引用符を使用して string を作成できるようになりました。

str = "bacon, lettuce, and tomato"

str = 
"bacon, lettuce, and tomato"

str を区切り記号で分割します。結果を string 配列に返し、区切り記号を 2 つ目の string 配列に返します。連続する区切り記号の間にテキストがない場合、split は空の string を返します。

[newStr,matches] = split(str,["and",","," "])

newStr = 7x1 string array
    "bacon"
    ""
    "lettuce"
    ""
    ""
    ""
    "tomato"

matches = 6x1 string array
    ","
    " "
    ","
    " "
    "and"
    " "

関数 join で newStr と matches を再び結合します。

originalStr = join(newStr,matches)

originalStr = 
"bacon, lettuce, and tomato"

入力引数

str — 入力テキスト

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

入力テキスト。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。

データ型: string | char | cell

delimiter — 区切りの部分文字列

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

区切りの部分文字列。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。delimiter に指定した部分文字列は、出力 newStr に現れません。

複数の区切り記号は、string 配列または文字ベクトルの cell 配列で指定します。関数 split は str を delimiter の要素で分割します。delimiter での区切り記号の出現順序が重要となるのは、複数の区切り記号の始まりが str 内の同じ文字に一致する場合のみです。そのような場合、関数 split は delimiter 内の最初に一致する区切り記号で文字列を分割します。

例: split(str,{' ',',','--'}) は、str を空白、コンマ、および連続するダッシュのペアのある位置で分割します。

データ型: string | char | cell

dim — 文字列を分割する次元

正の整数

文字列を分割する次元。正の整数として指定します。dim が指定されない場合、既定値はサイズが 1 ではない最後の配列次元です。

出力引数

newStr — 元の配列から分割された部分文字列

string 配列 | 文字ベクトルの cell 配列

元の配列から分割された部分文字列。string 配列または文字ベクトルの cell 配列として返されます。入力配列 str が string 配列の場合、newStr も string 配列です。それ以外の場合、newStr は文字ベクトルの cell 配列です。

データ型: string

matches — 指定された区切り記号

string 配列 | 文字ベクトルの cell 配列

指定された区切り記号。string 配列または文字ベクトルの cell 配列として返されます。入力配列 str が string 配列の場合、matches も string 配列です。それ以外の場合、matches は文字ベクトルの cell 配列です。

matches の要素の数は常に出力 newStr より 1 つ少なくなります。

データ型: string

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

参考

compose | join | newline | regexp | splitlines | sprintf | string

トピック

• string 配列の作成
• string 配列を使用したテキスト データの解析
• 正規表現

R2016b で導入