ソケット、プロセスおよびストリームの入出力

SenseTalkは、ソケット、プロセスおよび標準入出力ストリーム（つまりstdin、stdout、stderr）の読み取りと書き込みを行う一連のコマンドを提供します。基本的に、これらのフォームはすべてデータストリームとして処理できます。readおよびwriteコマンドには多くのオプションが存在し、これを使用することで、様々なフォーマットの数値やテキスト、生のバイナリデータなど、あらゆるタイプのデータの読み書きが容易になります。また、インターネット上での多くのサーバーとの通信をより簡潔にするために、HTTPおよびXML-RPCメッセージが直接サポートされます。

ストリームのタイプによって詳細が異なる部分もありますが、これらを操作する基本のプロセスはすべて同じシーケンスに従います。開く、読み取りおよび／または書き込み、閉じる。標準入力、標準出力および標準エラーのストリームは常に開いているとみなされるため、本シーケンスの主な例外は、これらのストリームは開閉を必要としないことです。

以下に、スクリプト内でソケット、プロセスおよびストリームの操作に使用するコマンド、関数、およびグローバルプロパティを示します。

• open socket / open process
• close socket
• read
• write
• openSockets() / openProcesses()
• the defaultStringEncoding

ソケットの出入力コマンド（open socket、close socket、read from socket、およびwrite … to socket）を使用すると、別のプロセスから提供されるソケットへの接続を開き、その接続を通してデータの読み書きを行うことが可能になります。ソケットは2つのプロセス間で開いている通信チャネルにすぎないため、ソケット上の特定の場所をシークすることはできません。

同様に、プロセスの出入力コマンド（open process、close process、read from process、およびwrite … to process）により、外部プロセスを起動し、そのプロセスの標準入力への書き込みと標準出力からの読み取りによって、そのプロセスとの通信が可能になります。

また、readおよびwriteコマンドは、標準入力からの読み取りと、標準出力または標準エラーストリームへの書き込みにも使用できます（read from input、write … to output、write … to error）。

openSockets()関数は、現時点で開いているすべてのソケットのリストを返します。

the defaultStringEncodingグローバルプロパティは、ファイルまたはソケットからテキストの読み書きを行う際に使用する符号化フォーマットを制御します。

Open Socketコマンド

挙動：readまたはwriteコマンドを利用してソケットからの読み取り取りまたはソケットへの書き込みを行う前に、open socketコマンドを利用してソケットを開ける必要があります。ソケットの操作が終了したら、close socketコマンドを利用してソケットを閉じる必要があります。

Open socketは、別のプロセス（プログラム）へのTCPソケット接続を確立します。その他のプロセスは、同一のコンピュータ、またはネットワーク上のその他のコンピュータで実行します。使用するコンピュータは既に起動しており、SenseTalkが接続できるソケットを前もって登録しておく必要があります。接続の確立後は、データは双方が理解できる何らかの手段で、両方向に転送されます。

構文：

socketIdentifierはhost:portの形式とする必要があり、ここで、hostはマシンの名前またはIPアドレス、portは接続先のソケットのマシン上のポート番号を指します。

socketIdentifierはオプションで、末尾にナンバー記号「#」（またはバーティカルバー「|」）とその後に任意の数または識別子の文字列を付けることができます。これは、同じホストとポートへの2つ以上の接続を確立し、各接続を一意に特定するのに複数の識別子を作成できるようにするという目的に適合します。すなわち、read、writeおよびcloseコマンドと一緒に適切なsocketIdentifierを使用することで、正しい接続を特定できます。

readTimeoutグローバルプロパティで指定された時間内にソケット接続を確立できない場合は、例外が投げられます。現在開いているすべてのソケットのリストを入手するには、openSockets()関数を使用します。

例：

例：

例：

Open Processコマンド

挙動：外部プロセスを起動し、スクリプトがそのプロセスとやり取りするための接続を開きます。外部プロセスを実行し、その完了時にこのプロセスから出力を受け取ることで十分な場合は、shell()関数を利用すると、これらの操作を非常に簡単に実行できます。一方、open processメカニズムは極めて高い柔軟性を提供するため、スクリプトが別のプロセスと複雑なやり取りを行ったり、スクリプトを遮断することなくかなり長い演算を開始し、スクリプトの後半でその演算の結果を回収することが可能になります。

Open processは、シェルの可能性がある（そして最も一般的にはシェルである）別のプロセス（プログラム）を起動し、これを介してその他のプログラムが継続して実行されます。別のプロセスの起動後は、接続が確立され、テキストが両方向に転送されます。すなわち、スクリプトがそのプロセスの標準入力への書き込み、および標準出力からの読み取りを行います。

プロセスを起動できない場合は、result()関数を例外に設定します（the throwExceptionResultsグローバルプロパティがtrueに設定されている場合は、例外が投げられます）。openProcesses()関数を利用すると、現在開いているすべてのプロセスのリストを入手できます。

構文：

processIdentifierは、processPath#identifierの形式をとる必要があります。ここで、processPathは実行するプロセスのフルパスを表します。processPathを省略すると、（the shellCommandグローバルプロパティで指定した）シェルプロセスが起動します。#identifierの部分はオプションであり、processIdentifierを一意にする方法として機能するにすぎないため、スクリプトは同じprocessPathを使用する複数のプロセスを一度に開いてやり取りすることができます。

optionsを使用する場合は、以下のプロパティのいずれかを含むプロパティリストである必要があります。

パラメータ	プロセスの起動時にパラメータとしてこのプロセスに渡される値のリスト
フォルダまたはディレクトリ	プロセスを実行する現在のディレクトリ
環境	環境変数とその値を指定するプロパティリスト

例：

例：

例：

Close Socket、Close Process、Close Allコマンド

挙動：単一のソケット、プロセス、または開いているすべてのファイル、ソケットもしくはプロセスを閉じます。close all socketsコマンドは、ソケットを開けたスクリプトやハンドラに関係なく、現在開いているすべてのソケットを閉じます。この挙動は、その他のスクリプトでソケットを開き、継続して使用している場合に問題となる可能性があります。現在開いているすべてのソケットのリストを入手するには、openSockets()関数を使用します。同様のことが、close all processesコマンドについても当てはまります。

close socketコマンドは、open socketコマンドによって開けられたソケットを閉じます。socketIdentifierは、ソケットを開ける際に使用した識別子と同じである必要があります。

close processコマンドは、open processコマンドによって開けられたプロセスを閉じます。processIdentifierは、プロセスを開ける際に使用した識別子と同じである必要があります。

close all socketsおよびclose all processesコマンドは、現在開いているすべてのソケットまたはプロセスを閉じるのに使用できます。スクリプトの実行が中止されるごとに、SenseTalkが開いているすべてのソケットとプロセスを自動的に閉じますが、操作の終了時にスクリプトがこれらを閉じるようにすることが推奨されます。

構文：

例：

例：

例：

Read from Socket、Read from Process、Read from Inputコマンド

挙動：開いているソケットもしくはプロセス、または標準入力ストリームからデータ（テキストまたは数字）を読み取ります。

read from ...コマンドを利用すると、ソケット、プロセス、または標準入力からデータを読み取ることができます。データの読み込み先となるのは、変数itか、格納先コンテナ（into節を使って指定した場合）です。読み取るデータがそれ以上なくなったら、格納先コンテナが空になります。要求よりも少ないデータが読み取られた場合は、result関数には常にその理由を与える値が含まれます（time outなど）。

readコマンドは、特定の数の文字や単語、アイテム、行の読み取り、または指定された区切り文字が見つかるまで読み取りを行ったり、複数の異なるタイプの数値のいずれかのリストを読み取ることができます。読み取りは、現在の位置から開始されます。readコマンドの構文には柔軟性があり、さまざまなオプションを都合の良い順番で指定することができます。

構文：

オプション：

読み取り先のソースを指定するには、3つのfromオプションのいずれかを使用する必要があります。その他のオプションは任意で使用できますが、タイプごとに1つのオプションを指定できます。forオプションもuntilオプションも指定しない場合は、単一の文字が読み取られます。

例：

例：

例：

例：

例：

テキストチャンクタイプの代わりに数値のデータタイプを指定した場合、読み取りによってitまたはコンテナに格納される値は、読み取られたデータ値のリストになります。使用できる数値のデータタイプは次のとおりです。

データタイプ	値
int1または8-bit integer	符号付き8ビット（1バイト）整数
uint1またはunsigned 8-bit integer	符号なし8ビット（1バイト）整数
int2または16-bit integerまたはshort integer	符号付き16ビット（2バイト）整数
uint2またはunsigned 16-bit integer	符号なし16ビット（2バイト）整数
int4または32-bit integerまたはinteger	符号付き32ビット（4バイト）整数
uint4またはunsigned 32-bit integer	符号なし32ビット（4バイト）整数
int8または64-bit integer	符号付き64ビット（8バイト）整数
uint8またはunsigned 64-bit integer	符号なし64ビット（8バイト）整数
real4または32-bit realまたはfloat	32ビット（単精度）浮動小数点数
real8または64-bit realまたはdouble	64ビット（倍精度）浮動小数点数

Write to Sockets、Write to Process、Write to Output、Write to Errorコマンド

挙動：ソケットもしくはプロセス、または標準出力ストリームもしくは標準エラーストリームにデータを書き込みます。データには、有効な任意のSenseTalk式を入れることができます。データタイプを指定しない場合、データ式の値は、文字列として扱われ、指定のソケットまたはストリームに書き出されます。

socketIdentifier式は、open socketコマンドを用いて事前に開けたソケットの識別子を生成する必要があります。

processIdentifier式は、open processコマンドを用いて事前に開けたプロセスの識別子を生成する必要があります。書き込まれたデータは、プロセスの標準入力に送られます。

as データタイプを指定した場合、書き込み前にデータがバイナリ形式に変換されます。この場合は、データを数値リストとすることができ、これらはすべて同じデータタイプに変換されます。有効なデータタイプの一覧については、readコマンドを参照してください。

構文：

例：

例：

例：

OpenSockets関数

挙動：open socketコマンドの結果として、現在開いているすべてのソケットのリストを返します。

構文：

例：

OpenProcesses関数

挙動：open processコマンドの結果として、現在開いていてやり取りに利用できるすべてのプロセスのリストを返します。

構文：

例：

 

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

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