メインコンテンツまでスキップ
バージョン：23.5

SenseTalkを使用してシステム情報にアクセスする

これらの関数は、SenseTalkスクリプトが実行されているシステムのさまざまな側面に関する情報を提供します。

DiskSpace関数​

Behavior: ディスク上の使用可能な空きスペースのバイト数を返します。

diskSpace関数を使用して、ファイルシステム上の使用可能な空きスペース（バイト単位）を確認します。

Parameters: 既存のファイルまたはフォルダの名前。任意。

diskSpace関数がパラメータなしで呼び出されると、現在の作業フォルダを含むファイルシステムの空きスペースの量（バイト単位）を返します。パラメータが与えられた場合、それは既存のファイルまたはフォルダの名前であるべきで、diskSpaceはそのファイルまたはフォルダを含むファイルシステム上の空きスペースの量を返します。

ノート

fileOrFolderが指定されていない場合、diskSpace関数は、the folderグローバルプロパティによって示されるように、現在の作業フォルダを含むボリューム上の使用可能なスペースの量を返します。

Syntax:
the diskSpace {of fileOrFolder} diskSpace({fileOrFolder})

例:

put diskSpace() into spaceRemaining
if diskspace is less than a Megabyte then
put "You have less than a megabyte of space remaining!"
end if
if diskSpace("/Volumes/sparky") is less than 1000 then
  put "Less than a thousand bytes left on /Volumes/sparky!!"
end if

EggplantVersion関数​

Behavior: Eggplant Functionalのバージョン番号を返します。

Parameters: なし。

Returns: Eggplant Functionalのバージョン番号。例: Eggplant 19.2.1-Windows

例:

log the eggplantVersion

Env関数​

Behavior: env関数は、SenseTalkが動作している環境から提供される環境変数へのアクセスを提供します。

Parameters: 一つの環境変数。任意。

特定の環境変数の名前をパラメータとしてenvを呼び出すと、その変数の値が取得されます。パラメータなしでenvを呼び出すと、すべての環境変数を含むプロパティリストが取得されます。

Syntax:
the env {of varName} env({varName})

例:

put env("Home") into homeFolder
put env() -- 利用可能なすべての情報を表示する

HostAddresses関数​

Behavior: hostAddresses関数は、SenseTalkが実行されているホストコンピュータのすべてのIPアドレスのリストを返します。

hostAddressesを呼び出して、ローカルホストのすべてのネットワークIPアドレスを検索します。

Parameters: なし。

Syntax:
the hostAddresses
hostAddresses()

例:

put item 1 of the hostAddresses into myIPAddress

HostName, HostNames関数​

Behavior: hostName関数は、スクリプトが実行されているマシンの標準ホスト名を返します。hostNames関数は、すべての既知のホスト名のリストを返します。

hostNameまたはhostNamesを呼び出して、ローカルホストがネットワーク上で知られている名前を検索します。

Parameters: なし。

Syntax:
the hostName
hostName()
the hostNames
hostNames()

例:

put the hostName into localName

Machine 関数​

Behavior: SenseTalkが動作しているコンピュータのマシンハードウェアのタイプを返します。

マシンハードウェアプラットフォームを判断するために Machine を呼び出します。

Parameters: なし。

Syntax:
the machine
machine()

例:

if the machine is "i386" then put "Intel" into hardwareType

OSInfo 関数​

Behavior: OS情報 関数は、SenseTalkが動作しているマシンのオペレーティングシステムに関する情報を含むプロパティリストを返します。

ホストオペレーティングシステムに関する情報を学ぶために OSInfo を呼び出します。

Parameters: なし。

Syntax:
the OSInfo
OSInfo()

例:

put the OSInfo

Platform 関数​

Behavior: Platform 関数は、SenseTalkが動作しているホストオペレーティングシステムの名前を返します、例えば "MacOS", "Linux" など。

SenseTalkのホストプラットフォームに基づいて判断を行うために Platform を呼び出します。

Parameters: なし。

Syntax:
the platform
platform()

例:

if the platform is "MacOS" then exit script

プロセス情報 関数​

Behavior: ProcessInfo 関数は、スクリプトが実行中のプロセスに関する情報を含むプロパティリストを返します、これにはその名前、パラメータ、プロセスIDが含まれます。

スクリプトを実行しているプロセスの身元情報を得るために プロセス情報 を呼び出します。

Parameters: なし。

Syntax:
the processInfo
processInfo()

例:

put the processInfo

Processor 関数​

Behavior: Processor 関数は、SenseTalkが動作しているホストコンピュータのプロセッサのタイプを返します、例えば "x86", "Power Macintosh" など。

ローカルホストのCPUタイプを判断するために Processor を呼び出します。

Parameters: なし。

Syntax:
the processor
processor()

例:

プロセッサをCPUTypeに入れる

SystemInfo 関数​

Behavior: systemInfo 関数は、SenseTalkが動作しているシステムに関する情報の各部分を含むプロパティリストを返します。

ローカルホストのメモリの量やプロセッサのバイト順などの情報を学ぶために systemInfo を呼び出します。

Parameters: なし。

Syntax:
the systemInfo
systemInfo()

例:

put the systeminfo's memorySize /1 GB into gigaBytes
if systemInfo().NativeByteOrder is "Big-Endian" then swap

SystemVersion 関数​

Behavior: SystemVersion 関数は、Eggplant Functionalが動作しているシステムのバージョン番号を返します。

スクリプトがどのOSバージョンで実行されているかをチェックするために SystemVersion を使用します。

Parameters: なし。

Syntax:
the systemVersion
systemVersion()

例:

if systemVersion() begins with "10.5" then put "Leopard!"

UserInfo 関数​

Behavior: userInfo 関数は、SenseTalkが動作しているユーザアカウントに関する様々な情報を含むプロパティリストを返します。

ログインしているユーザの情報を取得するために、その FullName, ShortName, および HomeDirectoryなど、userInfoを呼び出します。

Parameters: なし。

Syntax:
the userInfo
userInfo()

例:

put the userInfo's FullName into fullName
set the folder to userInfo().HomeDirectory

Version, Long Version, SenseTalkVersion, BuildNumber 関数​

Behavior: これらの関数はそれぞれ、アプリケーションの現在のバージョン番号（数値）、バージョンの長い形（より多くの情報を含む文字列）、使用されているSenseTalkエンジンのバージョン（数値）、および現在のビルド番号（整数）を提供します。

これらの関数を使用して、どのバージョンのアプリケーションやSenseTalkが使用されているかを特定します。例えば、特定の機能が利用可能かどうかを判断し、それ以外の場合はそれを使用しないようにするために役立つかもしれません。

Parameters: なし。

Syntax:
the {long} version
version()
the senseTalkVersion
senseTalkVersion()
the buildNumber
buildNumber()

構文:

if version() >= 2.0 then useAdvancedFeatures
put the long version
if the senseTalkVersion < requiredVersion then exit all
put buildNumber() into latestBuildUsed
に最終更新