ファイルおよびファイルシステムに関するローカル／グローバルプロパティ

ここで説明するローカルプロパティとグローバルプロパティは、ファイルおよびファイルシステムオブジェクトに対するSenseTalkスクリプトのアクセスまたはやり取りの方法に影響を与えるものです。SenseTalkにおけるファイルおよびファイルシステムの扱い方に関する追加情報は、ファイルやフォルダの参照およびファイルやフォルダとのやり取りをご覧ください。

ローカルプロパティとグローバルプロパティの扱い方に関する追加情報は、SenseTalkにおけるローカルプロパティとグローバルプロパティをご覧ください。

the folder、the directoryグローバルプロパティ

値：現在の作業ディレクトリのパス

デフォルト：通常はDocumentsフォルダのパス。ただし、PreferencesのGeneralセクションにあるDefault Suite Directory設定を更新することにより変更可能です。

挙動：このプロパティでは、現在の作業フォルダへのアクセスや変更を行うことができます。the folderの戻り値は、the folderNamesEndWithSlashグローバルプロパティがfalseに設定されていない限り、スラッシュで終わります。末尾にスラッシュがあると、ファイル名を追加することで簡単にフルパス名が作成できます（下記の例を参照）。

例：

例：

例：

例：

関連：

• the folderNamesEndWithSlash
• folder、directory関数

the folderNamesEndWithSlashグローバルプロパティ

値：True、False

デフォルト：True

挙動：このプロパティでは、フォルダまたはディレクトリ名を返すときに末尾にスラッシュを付けるかどうかを決定します。このプロパティが適用されるのは、the folderおよびthe directoryグローバルプロパティと、ディレクトリパスを返す各種SenseTalkコマンドおよび関数です。

例：

例：

例：

関連：

• the folder、the directoryグローバルプロパティ
• folder、directory関数
• resolvedFilePath関数

the strictFilesグローバルプロパティ

値：True、False

デフォルト：False

挙動：このプロパティでは、実行時におけるファイル使用の管理を厳格化することができます。このプロパティをTrueに設定すると、存在しないファイルをコンテナとして読み取ったときに、空が返されるのではなく、例外が投げられます。

Falseに設定すると、存在しないファイルからの読み取り時において、そのファイルが空であるかのように値が返されます。この振る舞いが時に予期しない結果を生むことがあります。例えば、ファイル名を誤って入力した場合、スクリプトはそれを空として扱ってしまい、ファイルが見つからない旨のエラーは出されません。

例：

例：

関連：

• the strictProperties
• the strictVariables

the defaultStringEncodingグローバルプロパティ

値：現在の文字列エンコード方法。利用可能な値の全リストは、the availableStringEncodings()関数を使って確認します。

デフォルト：UTF8

挙動：このプロパティでは、ファイル、ソケットまたはURLの読み書き時におけるテキスト文字列のエンコード方法を指定します。この設定は、readおよびwriteコマンドで使われる他、ファイルまたはURLをコンテナとして扱うときにも使われます。the defaultStringEncodingで受け入れ可能な値には、UTF8、Unicode、ASCII、他多数があります。

例：

例：

例：

例：

the umaskグローバルプロパティ

値：3桁の数字（詳しい説明は振る舞いをご覧ください）

デフォルト：022

挙動：新しく作成されるファイルのposixパーミッションマスクを設定または取得します。the umaskプロパティは、直接的にせよ間接的にせよSenseTalkで作成するあらゆるファイルまたはフォルダのアクセスパーミッションを管理するためのものです。マスクは3桁の数字から成り、各数字でユーザー、グループ、その他のファイルパーミッションをそれぞれ管理しています。それぞれの数字は0～7から成り、それによってブロックされるパーミッションを示します。値4は読み取りパーミッションのブロックに、2は書き込みパーミッションのブロックに、1は実行パーミッションのブロックにそれぞれ使われます。2つ以上のパーミッションをブロックするときは、これらの値を足し合わせます。

例：

例：

関連：

• ファイルやフォルダとのやり取り

the autoSaveDatabaseUpdatesグローバルプロパティ

値：True、False

デフォルト：True

挙動：このプロパティでは、データベースへの更新を自動的に保存するかどうかを決定します。Trueに設定すると、すべての更新が自動的に保存されます。save changesコマンドを使って手動で変更の書き込みを行いたい場合は、Falseに設定します。

例：

例：

関連：

• マニュアルデータベースアップデート

the shellCommandグローバルプロパティ

値：shellコマンドを実行するシェルプログラムのフルパス、ShellExecute、empty

デフォルト：プラットフォームによって異なります（次の振る舞いを参照）。

挙動：このプロパティでは、shellコマンドまたは関数の使用時に、どのシェルプログラムを使ってコマンドを実行するかを管理します。デフォルトでは、MacおよびLinuxのthe shellCommandは/bin/sh（Bourne shell）に設定されています。別のシェルでコマンドを実行するには、the shellCommandを、使用したいシェルのフルパスに設定してからshell関数を呼び出すか、「ShellExecute」またはemptyに設定します。

Windowsでは、the shellCommandグローバルプロパティのデフォルト設定がShellExecuteになっています。この設定により、指定ファイルの実行にWindows ShellExecute()関数が使われます。

WindowsでShellExecuteを使用するときは、コマンドまたは関数の他にオプションでいくつかの追加パラメータを渡すことができます。第2のパラメータは、与えられた場合、実行されるコマンドに渡されるパラメータを指定します。第3のパラメータは、そのアクションのデフォルト作業ディレクトリを指定します。第4のパラメータは、基礎となるShellExecute()関数に渡すオプションのフラグを指定する数値を取ります。最後に、第5のパラメータは、与えられた場合、使用する明確な動詞（open、explore、edit、findまたはprintなど）を指定します。これを与えない場合は、レジストリで定義されているデフォルトの動詞（またはopen）が使われます。（ShellExecuteの使用時、出力は返されません。）エラーが起こると、the resultが数値に設定されます。それ以外の場合は空になります。

the shellCommandがemptyでなく、かつ、ShellExecuteに設定されていない場合（デフォルトで/bin/shに設定されているMacおよびLinuxの標準的なケース） 、shell関数に複数のパラメータを渡すと、1つのシェルコンテキスト内で連続して各々実行されるべき別個のコマンドとして扱われます。

the shellCommandがemptyの場合、shellは最初のパラメータを実行すべきコマンドとして扱い、追加のパラメータをそのコマンドに渡されるパラメータとして扱います。渡されたパラメータが1つだけの場合、そのパラメータ内にスペースがあればそこで区切られ、コマンドとそのパラメータが導き出されます。

例：

例：

関連：

• shellコマンドと関数

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant