</head> <body> <h1>SubStr</h1> <p>文字列の指定された位置から、1文字または複数文字を取得します。</p> <pre class="Syntax">NewStr := <span class="func">SubStr</span>(String, StartingPos <span class="optional">, Length</span>)</pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>String</dt> <dd> <p>型:<a href="../Concepts.htm#strings">文字列</a></p> <p>内容がコピーされる文字列。バイナリーゼロを含む場合があります。</p> </dd> <dt>StartingPos</dt> <dd> <p>型:<a href="../Concepts.htm#numbers">整数</a></p> <p>1文字目から始める場合は1、2文字目から始める場合は2、と指定する。<em>StartingPos</em>が0または<em>String</em>の長さを超えている場合、空の文字列が返される。</p> <p>負の<em>StartingPos</em>を指定すると、その位置で右からスタートする。例えば、-1は最後の1文字を抽出し、-2は最後の2文字を抽出する。<em>StartingPos</em>が文字列の左端を超えようとすると、抽出は最初の文字から始まる。</p> </dd> <dt>Length</dt> <dd> <p>型:<a href="../Concepts.htm#numbers">整数</a></p> <p>省略したときは、"全ての文字"が初期値になります。そうでない場合は、取得する最大文字数を指定する(文字列の残りの部分が短すぎる場合は常に、最大文字数より少ない文字数が取得される)。</p> <p>また、負の<em>Length</em>を指定すると、返される文字列の末尾からその文字数だけ文字列を省略することができます(すべての文字が省略された場合、または文字数が多すぎる場合は、空の文字列が返されます)。</p> </dd> </dl> <h2 id="Return_Value">戻り値</h2> <p>型:<a href="../Concepts.htm#strings">文字列</a></p> <p>この関数は、指定された文字列の、要求された部分文字列を返します。</p> <h2 id="Related">関連</h2> <p><a href="RegExMatch.htm">RegExMatch</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> 長さ 3 文字の部分文字列を位置 4 で取得する。</p> <pre>MsgBox SubStr("123abc789", 4, 3) <em>; Returns abc</em></pre> </div> <div class="ex" id="ExStartEnd"> <p><a class="ex_number" href="#ExStartEnd"></a> 文字列の先頭と末尾から部分文字列を取り出す。</p> <pre>Str := "The Quick Brown Fox Jumps Over the Lazy Dog" MsgBox SubStr(Str, 1, 19) <em>; Returns "The Quick Brown Fox"</em> MsgBox SubStr(Str, -8) <em>; Returns "Lazy Dog"</em> </pre> </div> </body> </html>