英語勉強日記#2(翻訳がんばろう日記)
タレコミ by bananan_w
bananan_w 曰く、
というわけで、前のエントリがすらどっと日記の限界にぶつかったようで書き込めなくなったので新しいエントリで続き。
19.5.14 __split
19.5.14 __split
The split function splits the string passed to it according to the delimiter, and returns the original string. If any delimiters are adjacent, "?" is returned as the value. The split strings are returned in the variables ${VAR_1}, ${VAR_2} etc. The count of variables is returned in ${VAR_n}. From JMeter 2.1.2 onwards, a trailing delimiter is treated as a missing variable, and "?" is returned. Also, to allow it to work better with the ForEach controller, __split now deletes the first unused variable in case it was set by a previous split.
split関数は区切子に指定した文字によって文字列を分割し、元の文字列を返却します。区切子が連続する場合には、"?"が値として得られます。分割した文字列は変数 ${VAR_1}、${VAR_2}として得られます。分割した変数の数は ${VAR_n}変数から得られます。JMeter 2.1.2 以降では区切子が存在しない場合には "?" が得られます(訳注:要確認)。また、これは ForEach コントローラで使用する場合にうまく機能します。__split関数は直前に行なった分割によって変数が設定される場合に備えて、一番最初の未使用の変数を初期化します。
Example:
例:
Define VAR="a||c|" in the test plan.
VAR="a||c|"をテスト計画上で定義します。
${__split(${VAR},VAR),|}
This will return the contents of VAR, i.e. "a||c|" and set the following variables:
これはVARの中身("a||c|")を得て、以下の変数に値を設定します。
VAR_n=4 (3 in JMeter 2.1.1 and earlier)
VAR_n=4 (JMeter 2.1.1 以前では3)
VAR_1=a
VAR_2=?
VAR_3=c
VAR_4=? (null in JMeter 2.1.1 and earlier)
VAR_4=? (JMeter 2.1.1 以前ではnull)
VAR_5=null (in JMeter 2.1.2 and later)
VAR_5=null (JMeter 2.1.2 以降)
Parameters
Attribute Description Required
String to split A delimited string, e.g. "a|b|c" Yes
分割する文字列 区切子によって区切られた文字列、例:"a|b|c" 必須
Name of variable A reference name for reusing the value computed by this function. Yes
変数名 この関数で得られた値を再利用するための参照名。 必須
Delimiter The delimiter character, e.g. | . If omitted, , is used. Note that , would need to be specified as \, . No
区切子 区切子として指定する文字。例: | 。省略された場合には、 , が使用されます。, を指定する場合には、 \, とする必要があることに注意して下さい。
19.5.15 __XPath
19.5.15 __XPath
The XPath function reads an XML file and matches the XPath. Each time the function is called, the next match will be returned. At end of file, it will wrap around to the start.
XPath関数はXPathに適合する XML ファイルを読み込みます。関数が実行されるたびに次のマッチが得られます。ファイル終端に到達すると、ファイルの先頭に戻ります。
Note that the entire file is held in memory, so this function should not be used for very large files.
ファイル全体がメモリ上に格納されるので、関数は巨大なファイルに対して実行するべきではありません。
Example:
例:
${__XPath(/path/to/build.xml, //target/@name)}
This will match all targets in build.xml and return the contents of the next name attribute
build.xml の全てのtargetのマッチを取得し、次のname attributeコンテンツを取得します。
Parameters
Attribute Description Required
XML file to parse a XML file to parse Yes
パースするXMLファイル パースするXMLファイル 必須
XPath a XPath expression to match nodes in the XML file Yes
XPath XML ファイルのノードにマッチさせるXPath拡張表現 必須
19.5.16 __setProperty
19.5.16 __setProperty
The setProperty function sets the value of a JMeter property. The default return value from the function is the empty string, so the function call can be used anywhere functions are valid.
setProperty関数はJMeterプロパティに値を設定します。関数のデフォルトの文字列は空文字列です。関数はいかなる場所でも呼び出すことができます。
The original value can be returned by setting the optional 3rd parameter to "true".
第3引数に"true"を指定することによって、元の値を戻り値として得ることができます。
Properties are global to JMeter, so can be used to communicate between threads and thread groups
プロパティはJMeterにとってグローバルです。スレッドやスレッドグループの間で情報をやりとりするために使用できます。
Parameters
Attribute Description Required
Property Name The property name to be set. Yes
プロパティ名 設定するプロパティの名前 必須
Property Value The value for the property. Yes
プロパティの値 プロパティに設定する値 必須
True/False Should the original value be returned? No
True/False 元の値を戻り値とするか？ 省略可
19.5.17 __time
19.5.17 __time
The time function returns the current time in various formats.
time関数は現在時刻を可変フォーマットで得ることができます。
Parameters
Attribute Description Required
Format The format to be passed to SimpleDateFormat. The function supports various shorthand aliases, see below. No
フォーマット SimpleDateFormat形式に適合するフォーマット文字列。関数は略記の別名にも対応しています。いかに示します。 省略可
Name of variable The name of the variable to set. No
変数名 この関数で得られた値を再利用するための参照名。 省略可
If the format string is omitted, then the function returns the current time in milliseconds. Otherwise, the current time is passed to SimpleDateFormat. The following shorthand aliases are provided:
フォーマット文字列が省略された場合、関数は現在時刻のミリ秒を得ます(訳注：要実機確認)。それ以外の場合には、SimpleDateFormat形式に適合する現在時刻を取得します。以下の略記の別名が提供されます。
* YMD = yyyyMMdd
* HMS = HHmmss
* YMDHMS = yyyyMMdd-HHmmss
* USER1 = whatever is in the Jmeter property time.USER1
* USER1 = Jmeter のプロパティ time.USER1に設定された値
* USER2 = whatever is in the Jmeter property time.USER2
* USER2 = Jmeter のプロパティ time.USER2 に設定された値
The defaults can be changed by setting the appropriate JMeter property, e.g. time.YMD=yyMMdd
デフォルトをJMeterプロパティによって希望する形式に変更することができます。例:time.YMD=yyMMdd
19.5.18 __jexl
19.5.18 __jexl
The jexl function returns the result of evaluating a Commons JEXL expression . See links below for more information on JEXL expressions.
jexl関数は Common JEXL式による評価の結果を得ます。JEXL式の詳細については以下のリンクを参照して下さい。
* JEXL syntax description
* JEXL examples
Parameters
Attribute Description Required
Expression The expression to be evaluated. For example, 6*(5+2) Yes
式 評価する式。例: 6*(5+2) 必須
Name of variable The name of the variable to set. No
変数名 この関数で得られた値を再利用するための参照名。 省略可
(訳注：ここだけ書きっぷりが違う。とりあえずあわせた形にしとく)
The following variables are made available to the script:
以下の変数がスクリプトによって有効になります:
* ctx - JMeterContext object
* ctx - JMeterコンテキストオブジェクト
* vars - JMeterVariables object
* vars - JMeter変数オブジェクト
* props - JMeter Properties object
* props - JMeterプロパティオブジェクト
* threadName - String
* threadName - 文字列
* sampler - current Sampler object (if any)
* sampler - 現在のサンプラーオブジェクト(存在するなら）
* sampleResult - previous SampleResult object (if any)
* sampleResult - 直前のサンプラーの実行結果(存在するなら)
19.5.19 __V
19.5.19 __V
The V (variable) function returns the result of evaluating a variable name expression. This can be used to evaluate nested variable references (which are not currently supported).
V(variable)関数は変数名の値を取得します。入れ子構造の変数から数値を取得するために使用します(それらは現在サポートされていません)。
For example, if one has variables A1,A2 and N=1:
例として、変数A1とA2が存在し、N=1の場合:
* ${A1} - works OK
* ${A1} - 動作します。
* ${A${N}} - does not work (nested variable reference)
* ${A${N}} - 動作しません (入れ子変数の参照)。
* ${__V(A${N})} - works OK. A${N} becomes A1, and the __V function returns the value of A1
* ${__V(A${N})} - 動作します。 {N} は A1で、 __V 関数は A1 の値を得ます。
Parameters
Attribute Description Required
Variable name The variable to be evaluated. Yes
変数名 値を求める変数名 必須
