ファイルとファイルシステムのローカルとグローバルプロパティ
ここで説明するローカルプロパティとグローバルプロパティは、SenseTalkスクリプトがファイルやファイルシステムオブジェクトにアクセスしたり、それらと対話したりする方法に影響します。SenseTalkでファイルやファイルシステムを操作するための追加情報については、File and Folder ReferencesとFile and Folder Interactionを参照してください。
ローカルプロパティとグローバルプロパティの値を設定または変更する:
SenseTalkのコマンド Set
または Put
を使用してグローバルプロパティの値を設定できます。これらのプロパティを参照するときは、通常の変数と区別するためにプロパティ名の前に the
を使用しなければなりません。
例:
set the searchrectangle to [1,2,2,3]
put 2 into the remoteworkinterval
このようにしてグローバルプロパティ内の特定の名前付きプロパティを追加または変更できます:
set the namedColors.pink to color("RGB,1.0,0.5,0.5") -- namedColors.pink を color("RGB,1.0,0.5,0.5") に設定します
set the listFormat's separator to " & " -- Sets the separator property of the listFormat global property
プロパティは、setoption
または setoptions
コマンドを使用して設定または更新することもできます。setoption
コマンドでは一つのプロパティを更新でき、setoptions
コマンドでは複数のプロパティを更新できます。
例:
setoption searchrectangle, [1,2,2,3]
setoptions {searchrectangle: [1,2,2,3], scriptlogging: yes
setoption
および setoptions
は、グローバルプロパティおよびローカルプロパティの使用に特化しているため、これらのコマンドのコマンド構文でプロパティ名から the
を省略します。
ローカルプロパティとグローバルプロパティの操作についての追加情報については、SenseTalkのローカルプロパティとグローバルプロパティを参照してください。
the folder
, the directory
Global Properties
Value: 現在の作業ディレクトリのパス
Default: 典型的にはドキュメントフォルダへのパスですが、この値はPreferencesのGeneralセクションのDefault Suite Directory設定を更新することで変更可能です。
Behavior: このプロパティを使用すると、現在の作業フォルダにアクセスしたり、その値を変更したりできます。the folder
によって返される値は、the folderNamesEndWithSlash
グローバルプロパティがfalseに設定されていない限り、スラッシュで終わります。この最後のスラッシュは、以下の例に示すように、ファイル名を追加することでフルパス名を簡単に作成できるようにします。
SenseTalkスクリプト内では、folder
とdirectory
は同じ意味で使用されます。スクリプト中でfolder
という語が使用されている場所では、代わりにdirectory
という語を使用できます。
例:
set the directory to "C:\Users\Carrie\Desktop\"
例:
set the folder to "C:\Users\Carrie\Desktop\"
例:
set the directory to "C:\Users\Carrie\Desktop\data\"
put the files of the folder into fileObjects // 現在の作業ディレクトリにあるファイルのファイルオブジェクトのリストを返し、変数に格納します。
例:
set the folder to "/tmp/myWorkArea" -- Sets the working folder
関連情報:
* `the folderNamesEndWithSlash`
- [
folder
,Directory
関数 stk-file-folder-references.md#folderfunction)
the folder
, the directory
グローバルプロパティ
Value: True
, False
Default: True
Behavior: このプロパティは、フォルダ名またはディレクトリ名が最後にスラッシュ付きで返されるかどうかを決定します。このプロパティは、the folder
およびthe directory
グローバルプロパティと、ディレクトリパスを返す各種のSenseTalkコマンドおよび関数に適用されます。 例:
例:
set the folderNamesEndWithSlash to false
例:
log the folder // 現在の作業ディレクトリを末尾にスラッシュを付けてログに記録します。例: 'C:/Users/Carrie/Documents/'
folderNamesEndWithSlash を false に設定します
log the folder // 現在の作業ディレクトリを末尾のスラッシュなしでログに記録します。例: 'C:/Users/Carrie/Documents'
例:
set the folderNamesEndWithSlash to false
put the folder & "\newfile.txt" into filepath // / はフォルダによって返されないため、有効なパスを作成するために / を連結します
関連項目:
the folder
,the directory
プロパティ- [
folder
,Directory
関数 stk-file-folder-references.md#folderfunction) - [
resolvedFilePath
関数 stk-file-folder-references.md#resolved)
the strictFiles
グローバルプロパティ
Value: True
, False
Default: False
Behavior: このプロパティは、ランタイム中のファイル使用に対するより厳密な制御を提供するために使用できます。このプロパティがTrue
に設定されている場合、存在しないファイルをコンテナとして読み取ると、例外がスローされ、空を返すのではありません。
False
に設定されている場合、存在しないファイルからの読み取りは、そのファイルが空であるかのように値を返します。この動作は、場合によっては予期しない結果をもたらすことがあります。例えば、ファイル名が間違って入力された場合、スクリプトはそれを空として扱い、ファイルが見つからないというエラーを出すのではなく。
例:
set the strictFiles to true
例:
set the StrictFiles to true
put file "C/Desktopmyfile.txt" into myData // Throws exception: StrictFilesViolation Attempt to read nonexistent file: C:/Users/Carrie/Documents/C/Desktopmyfile.txt'
関連情報:
the strictProperties
the strictVariables
the defaultStringEncoding
グローバルプロパティ
Value: 現在の文字列エンコーディング方法。利用可能な値の全リストを見るには、the availableStringEncodings()
関数を使用します:
put availableStringEncodings()
Default: UTF8
Behavior: このプロパティは、テキスト文字列がファイル、ソケット、またはURLから読み込まれたり書き込まれたりするときにどのようにエンコードされるかを指定します。この設定は、read
およびwrite
コマンドによって使用され、またファイルまたはURLをコンテナとして扱うときにも使用されます。the defaultStringEncoding
の許容される値には、UTF8、Unicode、ASCIIなどがあります。
例:
set the defaultStringEncoding to "ASCII"
例:
put BlackDiamond as data // Displays '<e29786>'
set the defaultStringEncoding to "Unicode"
put BlackDiamond as data // Displays '<fffec625>'
例:
"C:\Users\Carrie\Desktop\Data\characters.txt" を filePath に入れます // このパスのファイルにはユニコード文字が含まれています
DefaultStringEncoding を "Unicode" に設定します
put file filePath // ファイルからユニコード文字を表示します。例えば: ʘʤϬϮ
例:
put the defaultStringEncoding into origEncoding
set the defaultStringEncoding to "Unicode" -- Full 16-bit Unicode text
put myInternationalText into file "/tmp/twoByteText"
set the defaultStringEncoding to origEncoding -- Restores original val
デックトーク
SenseTalk内では、テキスト文字は単にそれ自体です:文字 A
は文字 A
であり、文字 é
は文字 é
(鋭いアクセント付きの e)です。しかし外部では、同じ文字がビットとバイトのシーケンスとして表されるさまざまな方法があります。それぞれのテキスト表現は エンコーディング
と呼ばれます。SenseTalkが使用する標準エンコーディングはUTF8であり、これはUnicode文字をエンコードするための広く使用されている8ビットシステムです。
the umask
グローバルプロパティ
Values: 3桁の数字;詳細な説明については Behavior セクションを参照してください
Default: 022
Behavior: 新しく作成されるファイルのposix権限マスクを設定または取得します。the umask
プロパティを使用して、SenseTalkによって直接または間接的に作成された任意のファイルやフォルダのアクセス権限を制御します。マスクは3桁の数字であり、各桁はそれぞれユーザ、グループ、他のユーザのファイル権限を制御します。各桁は、ブロックされる権限を示す0から7までの数字です。値4は読み取り権限をブロックし、2は書き込み権限をブロックし、1は実行権限をブロックします。複数の権限をブロックするためには、これらの値を合計します。
例:
set the umask to 077
例:
put the umask into origMask
set the umask to 247 -- ユーザーは書き込みできず、グループメンバーは読み取りできず、他のユーザーはすべての権限がブロックされるように設定します
create file "/tmp/permissionsTest"
set the umask to origMask -- 元の値に戻す
関連項目:
the autoSaveDatabaseUpdates
グローバルプロパティ
Values: True
, False
Default: True
Behavior: このプロパティは、データベースへの更新が自動的に保存されるかどうかを決定します。True
に設定すると、すべての更新が自動的に保存されます。save changes
コマンドを使用して手動で変更を書き込みたい場合は、このプロパティを False
に設定します。
例:
set the autoSaveDatabaseUpdates to false
例:
関連:
the shellCommand
グローバルプロパティ
Values: 実行したいシェルコマンドのフルパス; ShellExecute
; 空
Default: プラットフォームによります; 下記の Behavior セクションを参照してください。
Behavior: このプロパティは、shell
コマンドまたは関数を使用したときにどのシェルプログラムを使用してコマンドを実行するかを制御します。デフォルトでは、Mac および Linux では the shellCommand
は /bin/sh
(Bourne シェル)に設定されています。別のシェルでコマンドを実行するには、シェル関数を呼び出す前に the shellCommand
を使用したいシェルのフルパスに設定するか、"ShellExecute" または空に設定します。
Windowsでは、the shellCommand
グローバルプロパティのデフォルト設定は ShellExecute
です。この設定は、指定されたファイルを実行するためにWindowsの ShellExecute()
関数が使用されることを意味します。
Windowsで ShellExecute
を使用する場合、コマンドまたはファイル以外にも追加のパラメータをオプションで渡すことができます。2番目のパラメータ(指定された場合)は、実行されるコマンドに渡すパラメータを指定します。3番目のパラメータは、アクションのデフォルトの作業ディレクトリを指定します。4番目のパラメータは、基本的な ShellExecute()
関数に渡す任意のフラグを指定するための数値であるべきです。最後に、5番目のパラメータ(指定された場合)は、明示的な動詞を指定します(例えば open
, explore
, edit
, find
, print
)。それ以外の場合は、レジストリ(または open
)で定義されているデフォルトの動詞が使用されます。(ShellExecute
を使用すると、出力は返されません。)エラーが発生した場合、the result
は数値に設定されます。それ以外の場合は空になります。
the shellCommand
が空でなく、ShellExecute
に設定されていない場合(MacおよびLinuxでは通常のケースで、デフォルトでは /bin/sh
に設定されています)、複数のパラメータがシェル関数に渡される場合、それらはそれぞれが一つのシェルのコンテキスト内で順番に実行される別のコマンドとして扱われます。
the shellCommand
が空の場合、shell
はその最初のパラメータを実行するコマンドとして扱い、その他の追加のパラメータをそのコマンドに渡すパラメータとして扱います。単一のパラメータのみが渡された場合、パラメータ内に存在する任意のスペースでそれが分割され、コマンドとそのパラメータが導き出されます。
テックトーク
set the shellCommand to "ShellExecute"
shell "example.bat" -- 指定されたバッチファイルを実行します
例:
set the shellCommand to empty
put shell("ls -l") -- '-l' パラメータ付きで 'ls' コマンドを実行します
put shell("ls", "-l") -- 同じことを行います
Windowsオペレーティングシステムにはシェルコマンドを実行するときの制限があります。Windowsでシェルコマンドを実行すると、シェルコマンドからの出力は表示されません。この問題を解決するために、コマンドの出力をファイルにリダイレクトします。スクリプトが完了した後、ファイルの 内容を手動で読み取って結果を確認します。
shell "c:\windows\system32\cmd.exe", <</c "C:\Program Files (x86)\adt-bundle-windows-x86_64\sdk\platform-tools\adb" >> && MyCommand && "> someFile.txt"
put file "C:\wherever\someFile.txt"
関連: