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

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

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

DiskSpace関数

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

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

パラメータ: 既存のファイルまたはフォルダの名前。任意。

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関数

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

パラメータ: なし。

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

例:

log the eggplantVersion

Env関数

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

パラメータ: 一つの環境変数。任意。

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

Syntax:

the env {of varName}

env({varName})

例:

put env("Home") into homeFolder
put env() -- display all available information

HostAddresses関数

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

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

パラメータ: なし。

Syntax:

the hostAddresses

hostAddresses()

例:

put item 1 of the hostAddresses into myIPAddress

HostName, HostNames関数

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

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

パラメータ: なし。

Syntax:

the hostName

hostName()

the hostNames

hostNames()

例:

put the hostName into localName

マシン 関数

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

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

パラメータ: なし。

Syntax:

the machine

machine()

例:

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

OS情報 関数

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

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

パラメータ: なし。

Syntax:

the OSInfo

OSInfo()

例:

put the OSInfo

プラットフォーム 関数

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

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

パラメータ: なし。

Syntax:

the platform

platform()

例:

if the platform is "MacOS" then exit script

プロセス情報 関数

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

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

パラメータ: なし。

Syntax:

the processInfo

processInfo()

例:

put the processInfo

プロセッサ 関数

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

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

パラメータ: なし。

Syntax:

the processor

processor()

例:

プロセッサをCPUTypeに入れる

システム情報 関数

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

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

パラメータ: なし。

Syntax:

the systemInfo

systemInfo()

例:

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

システムバージョン 関数

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

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

パラメータ: なし。

Syntax:

the systemVersion

systemVersion()

例:

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

ユーザ情報 関数

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

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

パラメータ: なし。

Syntax:

the userInfo

userInfo()

例:

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

バージョン, ロングバージョン, SenseTalkバージョン, ビルド番号 関数

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

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

パラメータ: なし。

Syntax:

**** {long} バージョン

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