メインコンテンツまでスキップ
バージョン: 開発中

STRING LIST TO ARRAY

STRING LIST TO ARRAY ( resID ; strings {; resFile} )

引数説明
resIDIntegerリソースID番号、または 'group'要素の'id'属性 (XLIFF)
stringsText arraySTR#リソースから取り出した文字列、または 'group'要素から取り出した文字列 (XLIFF)
resFileTimeリソースファイル参照番号、または 省略時、開かれているすべてのXLIFFファイル リソースファイル

このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。

説明

STRING LIST TO ARRAYコマンドは以下の要素から構築されるstrings配列を生成します:

  • ストリングリスト (“STR#”) リソースに格納された、IDがresIDの文字列、または
  • 開かれたXLIFFファイル中、'group'要素の'id'属性がresIDである文字列 (後述の"XLIFFアーキテクチャとの互換性"を参照)。

リソースが見つからない場合strings配列はそのまま変更されず、システム変数OKに0が設定されます。

resFileに有効なリソースファイル参照番号を渡すと、そのリソースはそのリソースファイル内でのみ検索されます。resFileを省略した場合は、リソースチェーン内で最初に見つかったリソースのオカレンスが返されます。

STRING LIST TO ARRAYを呼び出す前に、配列stringsを文字列またはテキスト配列として宣言できます。配列を事前に定義しない場合、テキスト配列として作成されます。

注: ストリングリストリソースの各ストリングは、最大255文字を格納できます。

Tip: ストリングリストの総サイズを32Kに、また1リソースあたり数百文字列に制限しなければなりません。

XLIFFアーキテクチャとの互換性

4D v11より、STRING LIST TO ARRAYコマンドはXLIFFアーキテクチャと互換があります。コマンドはまずresIDstrIDに対応するリソースをすべての開かれたXLIFFファイル内で探します (resFile 引数が省略されていれば)。この場合、resIDgroup要素のid属性を表し、strIDtrans-unit要素のid属性を表します。値が見つからない場合、コマンドは引き続き開かれたリソースファイルを検索します。4DにおけるXLIFFアーキテクチャに関する詳細は4D Design Referenceマニュアルを参照してください。

システム変数およびセット

リソースが見つかるとOK変数に1が、そうでなければ0が設定されます。

参照

Get indexed string
Get string resource
Get text resource