BuildRowSetFromString

概要

指定した区切り記号で文字列を分割して、文字列から行セットを作成します。

構文

BuildRowSetFromString(1, 2)

関数のプロパティ

序数	型		説明
1	string	必須	行セットの作成に使用される値
2	string	必須	区切り記号として使用される文字 (コンマなど)

使用状況

1BuildRowsetFromString('123|456|789', '|')

3 つの行が含まれる行セットを返します。ただし、この関数は 1 列の行セットを返します。この列には割り当てられた名前は含まれません。

1123 456 789

以下のサンプルコードでは、属性名を渡して処理する方法を示しています。

1%%[
2Var @queryparams
3Var @row
4Var @name
5Var @value
6Set @queryparams = BuildRowsetFromString(QueryParameter('names'),'|')
7for @i = 1 to Rowcount(@queryparams) do
8Set @row = Row(@queryparams, @i)
9Set @name = Field(@row,1)
10Set @value = QueryParameter(@name)
11]%%
12Passed <b>name:</b> %%= v(@name) =%% with <b>value:</b> %%= v(@value) =%%<br/>
13%%[
14next @i
15]%%

以下の入力を渡した場合を考えます。

1names=career|firstname|lastname&career=marketer&firstname=Angela&lastname=Ruiz

AMPscript は以下を返します。

1Passed name: career with value: marketer
2Passed name: firstname with value: Angela
3Passed name: lastname with value: Ruiz

この関数は 1 列の行セットを返し、この列には割り当てられた名前は含まれないため、関数内では序数を使用して列を参照します。

1Field(Row(BuildRowSetFromString('123|456', '|'), 1), 1)