リファレンス loadStrings()

loadStrings()

テキストファイルを読み込んでArrayを作成します。

最初のパラメータpathは、常にファイルへのパスを示す文字列です。 ローカルファイルへのパスは相対パスにする必要があります。例えば、 loadStrings('/assets/data.txt')のようにします。 'https://example.com/data.txt'のようなURLは、ブラウザのセキュリティにより ブロックされる可能性があります。

2番目のパラメータsuccessCallbackはオプションです。関数が 渡された場合、例えばloadStrings('/assets/data.txt', handleData)のように、 データが読み込まれるとhandleData()関数が呼び出されます。 テキストデータから作成された配列がhandleData()の唯一の 引数として渡されます。

3番目のパラメータfailureCallbackもオプションです。関数が 渡された場合、例えばloadStrings('/assets/data.txt', handleData, handleFailure)のように、 読み込み中にエラーが発生するとhandleFailure()関数が呼び出されます。 ErrorオブジェクトがhandleFailure()の唯一の 引数として渡されます。

注意:データの読み込みには時間がかかる場合があります。loadStrings()preload()内で呼び出すことで、 setup()draw()で使用される前に データが確実に読み込まれます。

実例

シンタックス

loadStrings(path, [successCallback], [errorCallback])

パラメーター

path
String:

読み込むテキストファイルのパス。

successCallback
Function:

データが読み込まれた後に呼び出される関数。 配列が渡されます。

errorCallback
Function:

データの読み込みに失敗した場合に呼び出される関数。 Errorイベントオブジェクトが 渡されます。

リターン

String[]: 読み込まれたテキストを含む新しい配列。
Notice any errors or typos? Please let us know. Please feel free to edit src/io/files.js and open a pull request!

関連するリファレンス