なでしこのDLLに含まれる（なでしこから呼ばれる）関数はそんなに多くなく、
・ImportNakoFunction
・PluginInfo
・PluginVersion
・PluginRequire
・PluginInit
・PluginFin
の6つです。この内、自分でせっせといじる必要があるのは
・ImportNakoFunction
で、この中で自分の作成した関数（命令）を登録します。 たとえば、なでしこから
DLLに渡ってくる引数のチェックをする関数を作ったとします。
------ここから------
void _disp_nakovar(PHiValue pvar)
{
if (pvar != NULL)
{
switch (pvar->VType)
{
case varNil :
DBGPRINTF("Var is Nil(%d)\n", pvar->VType);
break;
case varInt :
DBGPRINTF("Var is Int(%d)\n", pvar->VType);
break;
case varStr :
DBGPRINTF("Var is Str(%d)\n", pvar->VType);
break;
default :
DBGPRINTF("Var is Unknown(%d)\n", pvar->VType);
break;
}
}
}
------ここまで------
あ、デバッグ用に作ったのでDBGPRINTF()とかなってますが、
中身はprintf()です。 PHiValuはなでしこの変数を格納するための
構造体（へのポインタ）で、これに変数の種類とかいろいろ書いて
ありあす。途中省略してますが、この構造体の中身みれば、
大体のことが分かります（…って言うか、なでしこからDLLに
渡される情報はこの構造体が全てです(^^; ）。
このままではなでしこに登録できませんので、なでしこの命令と
して登録できる形の関数を書く必要があります。
------ここから------
PHiValue __stdcall dnako_varchk(DWORD h)
{
PHiValue arg1 = 0;
PHiValue ret = 0;
NAKO_FUNCS *pfnako = _get_nako_funcs();
DBGPRINTF("Enter -- %s()\n", __FUNCTION__);
arg1 = pfnako->nako_getFuncArg(h, 0);
ret = pfnako->nako_var_new(NULL);
DBGVARCHK(arg1);
return(ret);
}
------ここまで------
なでしこに登録する命令は常にこの形になっています。
PHiValue __stdcall dnako_varchk(DWORD h)
は、戻り値がPHiValue、Windowsの関数コール規約__stdcall、関数名が
dnako_varchk（これはユーザーが任意に名前つけられます）、引数は
DWORD型のh一つだけとなります。
命令の引数から実際の変数を取得する場合は
・pfnako->nako_getFuncArg(h, 0)
を使用します。pfnakoは関数セットを構造体として持っていて、
そこへのポインタです。この関数を実行することで、引数のh
から、PHiValueの変数を引っ張ってこれる仕組みです。
命令の引数が複数ある場合は、
arg1 = pfnako->nako_getFuncArg(h, 0);
arg2 = pfnako->nako_getFuncArg(h, 1);
arg3 = pfnako->nako_getFuncArg(h, 2);
と、引数分実行すれば順番に取得できます。つまりnako_getFuncArg()
の第二引数は、変数のリストだか配列だかのインデックスってこと
ですね。先頭のインデックスは0です。
こうやって取得したarg1はPHiValue型ですので、必要に応じてここから
整数や文字列を取り出します。pfnakoの中に、
・nako_var2int() /*PHiValueからint型の値取り出し*/
・nako_var2str() /*PHiValueから文字列取り出し*/
などがあるので、必要に応じて使用します。
最後に、この関数はデバッグ用だったので、戻り値は特に必要なかった
ですが、実際に必要な場合には、
・ret = pfnako->nako_var_new(NULL);
でPHiValue型の空の変数を作成した後、
・nako_int2var()
などを使用して、PHiValue型に実際をセットし、これをなでしこに返します。
すると、それがなでしこ命令を実行した際の戻り値になるわけですね～♪
最後はこのdnako_varchk()をなでしこに登録します。上でも書きましたが
登録するのは、
ImportNakoFunction()の中身でやります。
------ここから------
NAKO_API(void) ImportNakoFunction(void)
{
NAKO_FUNCS *pfnako = _get_nako_funcs();
DBGPRINTF("Enter -- ImportNakoFunction()\n");
pfnako->nako_addFunction("DLL引数ダンプ", "A", dnako_varchk, 0);
}
------ここまで------
・pfnako->nako_addFunction("DLL引数ダンプ", "A", dnako_varchk, 0);
が実際に登録してる場所で、"DLL引数ダンプ"はなでしこの命令名、
"A"がその時の引数、 "dnako_varchk"が上で作ったCの関数名です。
最後の0は…分かりませんヾ(;´▽｀A``。サンプルに0が設定されてたので
0にしてあります…。
なでしこ命令の引数ですが、"A"と書いた部分に"A,B"と書いておけば
引数が2つってことになります。またここに"Aの"とか書いておけば、
なでしこ命令としても「AのDLL引数ダンプ」みたいに書けます。上の
場合は
・DLL引数ダンプ（A）
と、ちょっとC言語っぽくなりますが、今回は引数が多めの命令も
ありますので、これで統一します。
2013年8月31日土曜日
2013年8月24日土曜日
【なでしこ】プラグインを作ってみる ～設計編 その10～
最後はハンドル自体に対する関数です。
------ここから------
・ハンドルタイプ取得
書式：ハンドルタイプ（[int]ハンドル）
戻値：[int]ハンドルタイプ
説明：指定ハンドルの種別を取得する。戻り値は以下のとおり。
-1 ：エラー（使われてない、など）
1 ：バイト
2 ：バッファ（リングバッファ）
4 ：ファイル
8 ：キュー
16 ：スタック
32 ：ソケット
64 ：シリアルポート
・ハンドル解放
書式：ハンドル解放（[int]ハンドル）
戻値：なし
説明：取得したハンドルを解放する。対象がメモリの場合はメモリ
が解放され、バイナリ（ファイル）やソケットの場合は
それらがクローズされる。
------ここまで------
キューとかスタックにハンドルをつないだ場合、取得した際のタイプが
分からないのでそれを取得できる関数を用意します。
各関数群で「ハンドルを確保」した場合は、それを使わなくなった時点で
「ハンドル解放」します。ガーベージコレクトの様な高度な処理は内部で
持ってませんのでヾ(;´▽｀A``。
尚、解放時、ハンドルのタイプによって実施する処理は違ってるんですが
それはこの関数内部で判断して実施してるので、とにかくいらなくなったら
解放してください(^^;。
------ここから------
・ハンドルタイプ取得
書式：ハンドルタイプ（[int]ハンドル）
戻値：[int]ハンドルタイプ
説明：指定ハンドルの種別を取得する。戻り値は以下のとおり。
-1 ：エラー（使われてない、など）
1 ：バイト
2 ：バッファ（リングバッファ）
4 ：ファイル
8 ：キュー
16 ：スタック
32 ：ソケット
64 ：シリアルポート
・ハンドル解放
書式：ハンドル解放（[int]ハンドル）
戻値：なし
説明：取得したハンドルを解放する。対象がメモリの場合はメモリ
が解放され、バイナリ（ファイル）やソケットの場合は
それらがクローズされる。
------ここまで------
キューとかスタックにハンドルをつないだ場合、取得した際のタイプが
分からないのでそれを取得できる関数を用意します。
各関数群で「ハンドルを確保」した場合は、それを使わなくなった時点で
「ハンドル解放」します。ガーベージコレクトの様な高度な処理は内部で
持ってませんのでヾ(;´▽｀A``。
尚、解放時、ハンドルのタイプによって実施する処理は違ってるんですが
それはこの関数内部で判断して実施してるので、とにかくいらなくなったら
解放してください(^^;。
【なでしこ】プラグインを作ってみる ～設計編 その9～
シリアル通信用の関数群です。組み込み系の仕事してると、
ボードとの通信は大体シリアルなので、日常的にシリアル
通信を使います。なでしこにはRS232Cのプラグインも入って
ますが、以前使ったら文字列しか送受信できないみたいだったので
再定義します。
------ここから------
・シリアルオープン
書式：シリアルオープン（[int]ポート、[int]ボーレート）
戻値：[int]ハンドル
説明：ポートとボーレートを指定して、シリアルポートをオープン
する。ポート、ボーレート以外のパラメータは、
データ ：8bit
パリティ ：なし
ストップ ：1bit
フロー制御：なし
となる。
成功した場合は0以上のハンドル値が返される。失敗した場合は
-1が返される。
・シリアル送信
書式：シリアル送信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドル、及びバッファ確保した
ハンドルを指定してサイズ分のデータを送信する。
成功した場合には送信出来たサイズが、失敗した場合には-1が
返される。
・シリアル受信
書式：シリアル受信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドル、及びバッファ確保した
ハンドルを指定してサイズ分のデータを受信する。
成功した場合には受信サイズが、失敗した場合には-1が
返される。
・シリアルデータサイズ
書式：シリアルデータサイズ（[int]ハンドル）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドルで指定されるシリアル
ポートに対して、そのバッファに受信されているデータ
サイズを取得する。
ここでのバッファとは上記バッファ確保したものではなく
Windowsのシリアルドライバが保持している受信バッファで
ある。
------ここまで------
ネットワーク通信同様、受信にはスレッド＆リングバッファを使いたい
ところですが、こちらも受信関数だけです。リングバッファだけは作って
みたものの…。Windowsの場合はWindowsのデバドラ自体がバッファ
持ってるので、スレッドがなくても処理は可能です。
ボードとの通信は大体シリアルなので、日常的にシリアル
通信を使います。なでしこにはRS232Cのプラグインも入って
ますが、以前使ったら文字列しか送受信できないみたいだったので
再定義します。
------ここから------
・シリアルオープン
書式：シリアルオープン（[int]ポート、[int]ボーレート）
戻値：[int]ハンドル
説明：ポートとボーレートを指定して、シリアルポートをオープン
する。ポート、ボーレート以外のパラメータは、
データ ：8bit
パリティ ：なし
ストップ ：1bit
フロー制御：なし
となる。
成功した場合は0以上のハンドル値が返される。失敗した場合は
-1が返される。
・シリアル送信
書式：シリアル送信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドル、及びバッファ確保した
ハンドルを指定してサイズ分のデータを送信する。
成功した場合には送信出来たサイズが、失敗した場合には-1が
返される。
・シリアル受信
書式：シリアル受信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドル、及びバッファ確保した
ハンドルを指定してサイズ分のデータを受信する。
成功した場合には受信サイズが、失敗した場合には-1が
返される。
・シリアルデータサイズ
書式：シリアルデータサイズ（[int]ハンドル）
戻値：[int]サイズ
説明：シリアルオープンで取得済のハンドルで指定されるシリアル
ポートに対して、そのバッファに受信されているデータ
サイズを取得する。
ここでのバッファとは上記バッファ確保したものではなく
Windowsのシリアルドライバが保持している受信バッファで
ある。
------ここまで------
ネットワーク通信同様、受信にはスレッド＆リングバッファを使いたい
ところですが、こちらも受信関数だけです。リングバッファだけは作って
みたものの…。Windowsの場合はWindowsのデバドラ自体がバッファ
持ってるので、スレッドがなくても処理は可能です。
【なでしこ】プラグインを作ってみる ～設計編 その8～
なでしこでもプラグインのnakonet.dllを使うとネットワーク通信
できますが、もうちょっとソケットを意識した関数を作ります。
------ここから------
・ソケットオープン
書式：ソケットオープン（[int]タイプ）
戻値：[int]ハンドル
説明：タイプを指定してソケットを作成（オープンする）。
タイプには以下の何れかを指定する。
0 : TCP
1 : UDP
成功した場合には0以上のハンドル値が返される。失敗
した場合には-1が返される。
・ソケット接続待ち
書式：ソケット接続待ち（[int]ハンドル、[int]ポート）
戻値：[int]結果
説明：ソケットオープンで取得済のハンドルと、指定のポートを
使って、TCPで相手が接続してくるのを待つ。
成功した場合は0が、失敗した場合は-1が返される。成功
した場合、後述の「相手ＩＰアドレス取得」命令を使用
して、接続相手のアドレスを取得することが出来る。
・ソケット接続
書式：ソケット接続（[int]ハンドル、[str]相手のアドレス、[int]ポート）
戻値：[int]結果
説明：ソケットオープンで取得済のハンドルと、サーバ側のアドレス、
ポートを指定してTCPで接続する。
接続が成功した場合には0が、失敗した場合には-1が返される。
・ＴＣＰ送信
書式：ＴＣＰ送信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドル、且つこのソケットで
相手に接続している場合に、バッファで指定されるハンドル
のデータをサイズ分送信する。バッファはバッファ確保で
取得したハンドルを指定すること。
成功した場合には送信出来たサイズが返される。失敗した
場合には-1が返される。
・ＴＣＰ受信
書式：ＴＣＰ受信（[int]ハンドル、[int]バッファ）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドル、且つこのソケットで
相手に接続している場合に、バッファで指定されるハンドル
にデータを受信する。
成功した場合には受信出来たサイズが返される。失敗した
場合には-1が返される。
・ＵＤＰ送信
書式：ＵＤＰ送信（[int]ハンドル、[int]バッファ、[str]相手アドレス、[str]ポート）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドルと、送信対象のバッファ
のハンドル、及び相手アドレスとポートを指定してデータを
送信する。ソケットハンドルはUDPでオープンされていること。
成功した場合には送信サイズが返さえる。失敗した場合には
-1が返される。
・ＵＤＰ受信
書式：ＵＤＰ送信（[int]ハンドル、[int]バッファ、[str]ポート）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドルと、受信データ書きこみ
用のバッファハンドル、及びポートを指定してデータを受信
する。なお、ポートが設定されるのは最初の1回だけど、それ
以降は無視される。
成功した場合には受信出来たサイズが返される。失敗した
場合には-1が返される。
・相手ＩＰアドレス取得
書式：相手ＩＰアドレス取得（＃引数なし）
戻値：[str]相手ＩＰアドレス（文字列）
説明：TCP通信で接続した相手のアドレス、及びUDP通信で受信した
場合の相手のＩＰアドレスを文字列で返す。DLL内部では
1箇所でしか記憶していないので、複数ソケットを開いている
場合等は、最後に接続/受信させれたものが記憶される。
------ここまで------
普通ネットワーク系のプログラムは受信用にスレッド使うのが
一般的ですが、今回は関数だけ用意してスレッドには対応して
ません。なのでちょっと使いにくいかも…。UDPでちょっと送受信
するぐらいなら使えますかね。
できますが、もうちょっとソケットを意識した関数を作ります。
------ここから------
・ソケットオープン
書式：ソケットオープン（[int]タイプ）
戻値：[int]ハンドル
説明：タイプを指定してソケットを作成（オープンする）。
タイプには以下の何れかを指定する。
0 : TCP
1 : UDP
成功した場合には0以上のハンドル値が返される。失敗
した場合には-1が返される。
・ソケット接続待ち
書式：ソケット接続待ち（[int]ハンドル、[int]ポート）
戻値：[int]結果
説明：ソケットオープンで取得済のハンドルと、指定のポートを
使って、TCPで相手が接続してくるのを待つ。
成功した場合は0が、失敗した場合は-1が返される。成功
した場合、後述の「相手ＩＰアドレス取得」命令を使用
して、接続相手のアドレスを取得することが出来る。
・ソケット接続
書式：ソケット接続（[int]ハンドル、[str]相手のアドレス、[int]ポート）
戻値：[int]結果
説明：ソケットオープンで取得済のハンドルと、サーバ側のアドレス、
ポートを指定してTCPで接続する。
接続が成功した場合には0が、失敗した場合には-1が返される。
・ＴＣＰ送信
書式：ＴＣＰ送信（[int]ハンドル、[int]バッファ、[int]サイズ）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドル、且つこのソケットで
相手に接続している場合に、バッファで指定されるハンドル
のデータをサイズ分送信する。バッファはバッファ確保で
取得したハンドルを指定すること。
成功した場合には送信出来たサイズが返される。失敗した
場合には-1が返される。
・ＴＣＰ受信
書式：ＴＣＰ受信（[int]ハンドル、[int]バッファ）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドル、且つこのソケットで
相手に接続している場合に、バッファで指定されるハンドル
にデータを受信する。
成功した場合には受信出来たサイズが返される。失敗した
場合には-1が返される。
・ＵＤＰ送信
書式：ＵＤＰ送信（[int]ハンドル、[int]バッファ、[str]相手アドレス、[str]ポート）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドルと、送信対象のバッファ
のハンドル、及び相手アドレスとポートを指定してデータを
送信する。ソケットハンドルはUDPでオープンされていること。
成功した場合には送信サイズが返さえる。失敗した場合には
-1が返される。
・ＵＤＰ受信
書式：ＵＤＰ送信（[int]ハンドル、[int]バッファ、[str]ポート）
戻値：[int]サイズ
説明：ソケットオープンで取得済のハンドルと、受信データ書きこみ
用のバッファハンドル、及びポートを指定してデータを受信
する。なお、ポートが設定されるのは最初の1回だけど、それ
以降は無視される。
成功した場合には受信出来たサイズが返される。失敗した
場合には-1が返される。
・相手ＩＰアドレス取得
書式：相手ＩＰアドレス取得（＃引数なし）
戻値：[str]相手ＩＰアドレス（文字列）
説明：TCP通信で接続した相手のアドレス、及びUDP通信で受信した
場合の相手のＩＰアドレスを文字列で返す。DLL内部では
1箇所でしか記憶していないので、複数ソケットを開いている
場合等は、最後に接続/受信させれたものが記憶される。
------ここまで------
普通ネットワーク系のプログラムは受信用にスレッド使うのが
一般的ですが、今回は関数だけ用意してスレッドには対応して
ません。なのでちょっと使いにくいかも…。UDPでちょっと送受信
するぐらいなら使えますかね。
【なでしこ】プラグインを作ってみる ～設計編 その7～
バイト処理の関数に近いものがありますが、ビット処理の関数群です。
なでしこだけでなく、Luaとかもビット操作が弱い傾向にあるので、
こういう関数は意外に役にたつかも（Luaは5.2系でビット処理の関数が
入った様ですが）。
------ここから------
・ビットチェック
書式：ビットチェック（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象となるハンドルと、パターンを指定して、パターンビット
が対象に含まれているかチェックする。対象はバイト確保
されたハンドルであること。
パターンが含まれている場合には1(TRUE)が、含まれていない
場合は0(FALSE)が返される。引数が不正な場合には0が返される。
・ビットセット
書式：ビットセット（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象のハンドル値に、パターンビットを設定する。対象は
バイト確保されたハンドルを指定する。
成功した場合には0が、引数に不正があった場合には-1が
返される。
・ビットクリア
書式：ビットクリア（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象のハンドル値の、パターンで指定されるビットをクリア
する。対象はバイト確保されたハンドルであること。
成功した場合には0が、引数に不正があった場合には-1が
返される。
------ここまで------
普通にプログラミングしてるとあまり使わないんですが、組み込み
系のプログラムでレジスタいじったり、あと通信パケットの内容を
操作したりする場合は意外とビット操作が使われてます。これと
バイト操作系のところで定義した左右シフトの関数があれば、
大体のことは出来ますかね～ヾ(´ー｀ )ノ
なでしこだけでなく、Luaとかもビット操作が弱い傾向にあるので、
こういう関数は意外に役にたつかも（Luaは5.2系でビット処理の関数が
入った様ですが）。
------ここから------
・ビットチェック
書式：ビットチェック（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象となるハンドルと、パターンを指定して、パターンビット
が対象に含まれているかチェックする。対象はバイト確保
されたハンドルであること。
パターンが含まれている場合には1(TRUE)が、含まれていない
場合は0(FALSE)が返される。引数が不正な場合には0が返される。
・ビットセット
書式：ビットセット（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象のハンドル値に、パターンビットを設定する。対象は
バイト確保されたハンドルを指定する。
成功した場合には0が、引数に不正があった場合には-1が
返される。
・ビットクリア
書式：ビットクリア（[int]ハンドル、[int]パターン）
戻値：[int]結果
説明：対象のハンドル値の、パターンで指定されるビットをクリア
する。対象はバイト確保されたハンドルであること。
成功した場合には0が、引数に不正があった場合には-1が
返される。
------ここまで------
普通にプログラミングしてるとあまり使わないんですが、組み込み
系のプログラムでレジスタいじったり、あと通信パケットの内容を
操作したりする場合は意外とビット操作が使われてます。これと
バイト操作系のところで定義した左右シフトの関数があれば、
大体のことは出来ますかね～ヾ(´ー｀ )ノ
【なでしこ】プラグインを作ってみる ～設計編 その6～
今回の設計はファイルです。バイナリ形式でファイルを扱いますが、
「バイナリファイル～」と書くと長いので、「バイナリ～」とします。
------ここから------
・バイナリオープン
書式：バイナリオープン（[str]ファイル名、[int]モード）
戻値：[int]ハンドル
説明：ファイル名で指定されたファイルを、モードで指定された方法で
オープンする。モードには0,1,2,3の何れかを指定し、意味は
以下のとおり。
0 : 読込専用
1 : 書込専用
2 : 読み書き
3 : 追記
ファイルは常にバイナリとしてオープンされる。テキストモード
で扱いたい場合には、なでしこの組み込み命令を使用すると良い。
成功すると0以上のハンドルが返される。失敗した場合には-1が
返される（ファイルがない、モードが範囲外など）
・バイナリ読込
書式：バイナリ読込（[int]ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：バイナリオープンされているハンドルから、サイズ分を読み
込んで先ハンドル（バッファ）に書き込む。読み込めるサイズは
コピー先のバッファサイズに依存し、バッファサイズ以上の
データは読み込まない。読み込めたサイズは戻り値として
返される。
読み込み開始位置は現在の開始位置で、読み込む毎にオフセット
がプラスされる。現在の開始位置はバイナリ位置取得命令で
取得出来、位置の変更はバイナリシーク命令で可能である。
引数が不正な場合等、エラーの場合は-1が返される。
・バイナリ書込
書式：バイナリ書込（[int]ハンドル、[int]元ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：作成済みのバッファ（元ハンドル）からサイズ分読み込んで、
バイナリオープンされているハンドルに対して書き込む。
書き込めるサイズは元ハンドルのサイズに依存し、それ以上の
サイズを指定した場合は、書き込めるだけ書き込む。
（データがある分だけ書き込む）。書き込めたサイズが戻り値
として返される。
書込開始位置は、書込専用、読み書き用にオープンしている場合は
ファイルの先頭から開始し、書き込む毎にオフセットがプラスされ
る。既存ファイルの場合は一旦ファイルが消去されるので注意する
こと。追記モードの場合はファイルの終端から書込が開始される。
引数が不正な場合等、エラーの場合は-1が返される。
・バイナリシーク
書式：バイナリシーク（[int]ハンドル、[int]オフセット）
戻値：[int]オフセット
説明：バイナリオープンされているハンドルの読み込み・書込開始
位置をオフセットの値に設定する。オフセットは0以上の
値で、ファイルサイズ以上の値を設定した場合には、ファイルの
末尾となる。
成功した場合にはオフセット値が、失敗した場合には-1が
返される。
・バイナリ位置取得
書式：バイナリ位置取得（[int]ハンドル）
戻値：[int]位置
説明：バイナリオープンされているハンドルの、現在開始位置を
返す。引数が不正だった場合には-1が返される。
------ここまで------
ANSIでいう所のfopen, fread, fwrite, fseek, ftellに相当する関数です。
バイナリじゃない形式でファイルを扱いたい場合は、なでしこの「開く」
とか使ってください。
あと、今気がつきましたが、なでしこには「バイナリ取得」とか「バイナリ設定」
と言う命令がありますね（￣□￣；。混同しない様に気をつけて下さい。
「バイナリファイル～」と書くと長いので、「バイナリ～」とします。
------ここから------
・バイナリオープン
書式：バイナリオープン（[str]ファイル名、[int]モード）
戻値：[int]ハンドル
説明：ファイル名で指定されたファイルを、モードで指定された方法で
オープンする。モードには0,1,2,3の何れかを指定し、意味は
以下のとおり。
0 : 読込専用
1 : 書込専用
2 : 読み書き
3 : 追記
ファイルは常にバイナリとしてオープンされる。テキストモード
で扱いたい場合には、なでしこの組み込み命令を使用すると良い。
成功すると0以上のハンドルが返される。失敗した場合には-1が
返される（ファイルがない、モードが範囲外など）
・バイナリ読込
書式：バイナリ読込（[int]ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：バイナリオープンされているハンドルから、サイズ分を読み
込んで先ハンドル（バッファ）に書き込む。読み込めるサイズは
コピー先のバッファサイズに依存し、バッファサイズ以上の
データは読み込まない。読み込めたサイズは戻り値として
返される。
読み込み開始位置は現在の開始位置で、読み込む毎にオフセット
がプラスされる。現在の開始位置はバイナリ位置取得命令で
取得出来、位置の変更はバイナリシーク命令で可能である。
引数が不正な場合等、エラーの場合は-1が返される。
・バイナリ書込
書式：バイナリ書込（[int]ハンドル、[int]元ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：作成済みのバッファ（元ハンドル）からサイズ分読み込んで、
バイナリオープンされているハンドルに対して書き込む。
書き込めるサイズは元ハンドルのサイズに依存し、それ以上の
サイズを指定した場合は、書き込めるだけ書き込む。
（データがある分だけ書き込む）。書き込めたサイズが戻り値
として返される。
書込開始位置は、書込専用、読み書き用にオープンしている場合は
ファイルの先頭から開始し、書き込む毎にオフセットがプラスされ
る。既存ファイルの場合は一旦ファイルが消去されるので注意する
こと。追記モードの場合はファイルの終端から書込が開始される。
引数が不正な場合等、エラーの場合は-1が返される。
・バイナリシーク
書式：バイナリシーク（[int]ハンドル、[int]オフセット）
戻値：[int]オフセット
説明：バイナリオープンされているハンドルの読み込み・書込開始
位置をオフセットの値に設定する。オフセットは0以上の
値で、ファイルサイズ以上の値を設定した場合には、ファイルの
末尾となる。
成功した場合にはオフセット値が、失敗した場合には-1が
返される。
・バイナリ位置取得
書式：バイナリ位置取得（[int]ハンドル）
戻値：[int]位置
説明：バイナリオープンされているハンドルの、現在開始位置を
返す。引数が不正だった場合には-1が返される。
------ここまで------
ANSIでいう所のfopen, fread, fwrite, fseek, ftellに相当する関数です。
バイナリじゃない形式でファイルを扱いたい場合は、なでしこの「開く」
とか使ってください。
あと、今気がつきましたが、なでしこには「バイナリ取得」とか「バイナリ設定」
と言う命令がありますね（￣□￣；。混同しない様に気をつけて下さい。
2013年8月18日日曜日
【なでしこ】プラグインを作ってみる ～設計編 その5～
キューとスタックは一緒に。実際実装は殆ど一緒で、FIFOに
なるかFILOになるかの差です。
------ここから------
・キュー作成
書式：キュー作成（＃引数なし）
戻値：[int]ハンドル
説明：空のキューを作成して、そのハンドルを返す。キューに対しては
本ライブラリで生成出来るハンドルを追加・取得出来る（FIFO）。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・キュー追加
書式：キュー追加（[int]キュー、[int]ハンドル）
戻値：[int]結果
説明：指定のキューハンドルに、ハンドルを追加する。
成功した場合は0が、失敗した場合は-1が返される。
・キュー取得
書式：キュー取得（[int]キュー）
戻値：[int]ハンドル
説明：指定されたキューから、先頭の1要素を取得して返す。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・キュー要素数取得
書式：キュー要素数（[int]ハンドル）
戻値：[int]要素数
説明：指定されたキューに繋がれているハンドル数（要素数）を
返す。失敗した場合には-1が返される。
・スタック作成
書式：スタック作成（＃引数なし）
戻値：[int]ハンドル
説明：空のスタックを作成して、そのハンドルを返す。スタックに対しては
本ライブラリで生成出来るハンドルを追加・取得出来る（LIFO）。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・スタック追加
書式：スタック追加（[int]スタック、[int]ハンドル）
戻値：[int]結果
説明：指定のスタックハンドルに、ハンドルを追加する。
成功した場合は0が、失敗した場合は-1が返される。
・スタック取得
書式：スタック取得（[int]スタック）
戻値：[int]ハンドル
説明：指定されたスタックから、末尾の1要素を取得して返す。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・スタック要素数取得
書式：スタック要素数（[int]ハンドル）
戻値：[int]要素数
説明：指定されたスタックに繋がれているハンドル数（要素数）を
返す。失敗した場合には-1が返される。
------ここまで------
キュー、スタックを確保すると、管理用のヘッダが内部で生成されて
それにハンドルを追加していきます。追加できるハンドルは特に
種別を規定はしませんが…まあ普通はバイトハンドルかバッファ
ハンドルですね。
…と、今書いてて思い出しましたが…キューかスタックに繋がってる
ハンドルは今のところ無条件に開放できてしまうな（￣□￣；。
なんとかせねば…
なるかFILOになるかの差です。
------ここから------
・キュー作成
書式：キュー作成（＃引数なし）
戻値：[int]ハンドル
説明：空のキューを作成して、そのハンドルを返す。キューに対しては
本ライブラリで生成出来るハンドルを追加・取得出来る（FIFO）。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・キュー追加
書式：キュー追加（[int]キュー、[int]ハンドル）
戻値：[int]結果
説明：指定のキューハンドルに、ハンドルを追加する。
成功した場合は0が、失敗した場合は-1が返される。
・キュー取得
書式：キュー取得（[int]キュー）
戻値：[int]ハンドル
説明：指定されたキューから、先頭の1要素を取得して返す。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・キュー要素数取得
書式：キュー要素数（[int]ハンドル）
戻値：[int]要素数
説明：指定されたキューに繋がれているハンドル数（要素数）を
返す。失敗した場合には-1が返される。
・スタック作成
書式：スタック作成（＃引数なし）
戻値：[int]ハンドル
説明：空のスタックを作成して、そのハンドルを返す。スタックに対しては
本ライブラリで生成出来るハンドルを追加・取得出来る（LIFO）。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・スタック追加
書式：スタック追加（[int]スタック、[int]ハンドル）
戻値：[int]結果
説明：指定のスタックハンドルに、ハンドルを追加する。
成功した場合は0が、失敗した場合は-1が返される。
・スタック取得
書式：スタック取得（[int]スタック）
戻値：[int]ハンドル
説明：指定されたスタックから、末尾の1要素を取得して返す。
成功した場合にはハンドル値が、失敗した場合には-1が返される。
・スタック要素数取得
書式：スタック要素数（[int]ハンドル）
戻値：[int]要素数
説明：指定されたスタックに繋がれているハンドル数（要素数）を
返す。失敗した場合には-1が返される。
------ここまで------
キュー、スタックを確保すると、管理用のヘッダが内部で生成されて
それにハンドルを追加していきます。追加できるハンドルは特に
種別を規定はしませんが…まあ普通はバイトハンドルかバッファ
ハンドルですね。
…と、今書いてて思い出しましたが…キューかスタックに繋がってる
ハンドルは今のところ無条件に開放できてしまうな（￣□￣；。
なんとかせねば…
2013年8月17日土曜日
【なでしこ】プラグインを作ってみる ～設計編 その4～
もう1種類のバッファとして、リングバッファを準備します。シリアルのデータ
受信をスレッドにする場合にはリングバッファを仕様することが多いので、
前もって準備しておきます。
※なでしこではスレッドには対応してませんので、対応する場合は
DLL内でスレッドを生成することになります。…今のところ対応予定は
ないですが(^^;。
------ここから------
・リングバッファ確保
書式：バッファ確保（[int]サイズ）
戻値：[int]ハンドル
説明：メモリを動的に確保して、そのハンドルを返す。成功した場合、
0以上のハンドル値が、失敗した場合には-1が返される。
なお、メモリは動的に確保されているので、使用後はかならず
ハンドルの解放を実施して確保されたメモリ領域を解放する
こと。
「バッファ確保」と処理内容は一緒だが、以降このバッファは
リングバッファとして扱われる。
・リングバッファ読込
書式：リングバッファ読込（[int]ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：確保されているリングバッファハンドルから、サイズ分を読み
込んで先ハンドル(バッファ）に書き込む。読み込めるサイズは
コピー先のバッファサイズに依存し、バッファサイズ以上の
データは読み込まない。読み込めたサイズは戻り値として返される。
リングバッファなので、読み込みの開始位置は現在の読込位置
となり、読み込んだサイズ分は以降書込可能領域となる。
引数が不正な場合等、エラーの場合は-1が返される。
・リングバッファ書込
書式：リングバッファ書込（[int]ハンドル、[int]元ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：作成済みの元ハンドル（バッファ）からサイズ分読み込んで、
確保されているリングバッファハンドルに対して書き込む。
書き込めるサイズは元ハンドルのサイズに依存し、それ以上の
サイズを指定した場合は、書き込めるだけ書き込む。
（データがある分だけ書き込む）。書き込めたサイズが戻り値
として返される。
書き込み位置はリングバッファ中の書き込み可能な領域の先頭
からとなり、書き込んだ分は以降読込可能となる。書き込む前に
空き領域を知りたい場合には「リングバッファ空きサイズ」
命令でサイズを取得出来る。
引数が不正な場合等、エラーの場合は-1が返される。
・リングバッファ読込サイズ
書式：リングバッファ読込サイズ（[int]ハンドル）
戻値：[int]読込可能サイズ
説明：確保されているリングバッファハンドルの、現在読み込める
データサイズを返す。
引数が不正な場合等、エラーの場合は-1が返される。
------ここまで------
リングバッファは一つのバッファを、読み込み側と書き込み側で
共有するためのものです。まず書き込みを行って、その部分が
読み込まれれば、そこは再度書き込み可能となります。
バッファの先頭から書き始めて終端まで行ったらまた先頭に戻り、
そこが「書き込み可能」になっていればさらに書き込みます、リング
の様にグルグルとバッファを繰り返し使うのでリングバッファです。
受信をスレッドにする場合にはリングバッファを仕様することが多いので、
前もって準備しておきます。
※なでしこではスレッドには対応してませんので、対応する場合は
DLL内でスレッドを生成することになります。…今のところ対応予定は
ないですが(^^;。
------ここから------
・リングバッファ確保
書式：バッファ確保（[int]サイズ）
戻値：[int]ハンドル
説明：メモリを動的に確保して、そのハンドルを返す。成功した場合、
0以上のハンドル値が、失敗した場合には-1が返される。
なお、メモリは動的に確保されているので、使用後はかならず
ハンドルの解放を実施して確保されたメモリ領域を解放する
こと。
「バッファ確保」と処理内容は一緒だが、以降このバッファは
リングバッファとして扱われる。
・リングバッファ読込
書式：リングバッファ読込（[int]ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：確保されているリングバッファハンドルから、サイズ分を読み
込んで先ハンドル(バッファ）に書き込む。読み込めるサイズは
コピー先のバッファサイズに依存し、バッファサイズ以上の
データは読み込まない。読み込めたサイズは戻り値として返される。
リングバッファなので、読み込みの開始位置は現在の読込位置
となり、読み込んだサイズ分は以降書込可能領域となる。
引数が不正な場合等、エラーの場合は-1が返される。
・リングバッファ書込
書式：リングバッファ書込（[int]ハンドル、[int]元ハンドル、[int]サイズ）
戻値：[int]サイズ
説明：作成済みの元ハンドル（バッファ）からサイズ分読み込んで、
確保されているリングバッファハンドルに対して書き込む。
書き込めるサイズは元ハンドルのサイズに依存し、それ以上の
サイズを指定した場合は、書き込めるだけ書き込む。
（データがある分だけ書き込む）。書き込めたサイズが戻り値
として返される。
書き込み位置はリングバッファ中の書き込み可能な領域の先頭
からとなり、書き込んだ分は以降読込可能となる。書き込む前に
空き領域を知りたい場合には「リングバッファ空きサイズ」
命令でサイズを取得出来る。
引数が不正な場合等、エラーの場合は-1が返される。
・リングバッファ読込サイズ
書式：リングバッファ読込サイズ（[int]ハンドル）
戻値：[int]読込可能サイズ
説明：確保されているリングバッファハンドルの、現在読み込める
データサイズを返す。
引数が不正な場合等、エラーの場合は-1が返される。
------ここまで------
リングバッファは一つのバッファを、読み込み側と書き込み側で
共有するためのものです。まず書き込みを行って、その部分が
読み込まれれば、そこは再度書き込み可能となります。
バッファの先頭から書き始めて終端まで行ったらまた先頭に戻り、
そこが「書き込み可能」になっていればさらに書き込みます、リング
の様にグルグルとバッファを繰り返し使うのでリングバッファです。
【なでしこ】プラグインを作ってみる ～設計編 その3～
次に、メモリ（バッファ）制御系の関数の仕様を決めます。
------ここから------
・バッファ確保
書式：バッファ確保（[int]サイズ）
戻値：[int]ハンドル
説明：メモリを動的に確保して、そのハンドルを返す。成功した場合、
0以上のハンドル値が、失敗した場合には-1が返される。
なお、メモリは動的に確保されているので、使用後はかならず
ハンドルの解放を実施して確保されたメモリ領域を解放する
こと。
・バッファクリア
書式：バッファクリア（[int]ハンドル、[int]クリア値）
戻値：[int]結果
説明：バッファ確保命令で取得したハンドルの領域をクリア値を用いて
クリアする。クリア値には0～255(0xFF)までの1byte値を指定
する。
成功した場合は0が、無効なハンドル、クリア値を指定した
場合は-1が返される。
・バッファコピー
書式：バッファコピー（[int]元ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]結果
説明：既に確保されているコピー元ハンドルから、コピー先ハンドルに
データをコピーする。先ハンドルはバッファでなくては
ならないが、元ハンドルについてはバッファ、もしくは
上記バイト確保命令で取得したハンドルでも良い。
成功した場合は0が、無効なハンドルを指定した場合には-1が
返される。
・バッファ読込
書式：バッファ読込（[int]ハンドル、[int]オフセット）
戻値：[int]読込データ
説明：既に確保されているメモリ領域（ハンドル）の、所定のオフセット
位置から、1byteのデータを取得して返す。
無効な引数を指定した場合には0が返される。
・バッファ書込
書式：バッファ書込（[int]ハンドル、[int]オフセット、[int]データ）
戻値：[int]結果
説明：既に確保されているメモリ領域（ハンドル）の、所定のオフセット
位置に、1byteのデータを書き込む。データには0～255の値を
指定する。
成功した場合には0が、無効な引数を指定した場合には-1が
返される。
・バッファ比較
書式：バッファ比較（[int]ハンドル、[int]ハンドル、[int]サイズ）
戻値：[int]結果
説明：既に確保されている2つのバッファハンドルのサイズ分のデータ
を比較する。
比較した結果内容が同じであれば1、違っていれば0、エラーが
あった場合には-1を返す。
------ここまで------
一般的にCで実施するmalloc, memcpy, memset, memcmpなどが使える
様にするために上記の関数を準備します。読み書きは1byteずつに
しましたが、複数にした方がいいのかなあ…。バッファコピーもオフセット
はつけませんでしたが、任意の位置に任意のサイズコピーできるほうが
いい気がしてきたので、その内仕様を変更しようかと思います。
freeに相当する関数がここには含まれてませんが、ハンドルを開放する
ための関数を後ほど準備します。
※最終的なものは修正後、まとめて公開します。
------ここから------
・バッファ確保
書式：バッファ確保（[int]サイズ）
戻値：[int]ハンドル
説明：メモリを動的に確保して、そのハンドルを返す。成功した場合、
0以上のハンドル値が、失敗した場合には-1が返される。
なお、メモリは動的に確保されているので、使用後はかならず
ハンドルの解放を実施して確保されたメモリ領域を解放する
こと。
・バッファクリア
書式：バッファクリア（[int]ハンドル、[int]クリア値）
戻値：[int]結果
説明：バッファ確保命令で取得したハンドルの領域をクリア値を用いて
クリアする。クリア値には0～255(0xFF)までの1byte値を指定
する。
成功した場合は0が、無効なハンドル、クリア値を指定した
場合は-1が返される。
・バッファコピー
書式：バッファコピー（[int]元ハンドル、[int]先ハンドル、[int]サイズ）
戻値：[int]結果
説明：既に確保されているコピー元ハンドルから、コピー先ハンドルに
データをコピーする。先ハンドルはバッファでなくては
ならないが、元ハンドルについてはバッファ、もしくは
上記バイト確保命令で取得したハンドルでも良い。
成功した場合は0が、無効なハンドルを指定した場合には-1が
返される。
・バッファ読込
書式：バッファ読込（[int]ハンドル、[int]オフセット）
戻値：[int]読込データ
説明：既に確保されているメモリ領域（ハンドル）の、所定のオフセット
位置から、1byteのデータを取得して返す。
無効な引数を指定した場合には0が返される。
・バッファ書込
書式：バッファ書込（[int]ハンドル、[int]オフセット、[int]データ）
戻値：[int]結果
説明：既に確保されているメモリ領域（ハンドル）の、所定のオフセット
位置に、1byteのデータを書き込む。データには0～255の値を
指定する。
成功した場合には0が、無効な引数を指定した場合には-1が
返される。
・バッファ比較
書式：バッファ比較（[int]ハンドル、[int]ハンドル、[int]サイズ）
戻値：[int]結果
説明：既に確保されている2つのバッファハンドルのサイズ分のデータ
を比較する。
比較した結果内容が同じであれば1、違っていれば0、エラーが
あった場合には-1を返す。
------ここまで------
一般的にCで実施するmalloc, memcpy, memset, memcmpなどが使える
様にするために上記の関数を準備します。読み書きは1byteずつに
しましたが、複数にした方がいいのかなあ…。バッファコピーもオフセット
はつけませんでしたが、任意の位置に任意のサイズコピーできるほうが
いい気がしてきたので、その内仕様を変更しようかと思います。
freeに相当する関数がここには含まれてませんが、ハンドルを開放する
ための関数を後ほど準備します。
※最終的なものは修正後、まとめて公開します。
2013年8月15日木曜日
【なでしこ】プラグインを作ってみる ～設計編 その2～
では、バイト制御系の関数仕様を決めていこうと思います。
------ここから------
・バイト確保
書式：バイト確保（[int]バイト数、[int]初期値)
戻値：[int]ハンドル
説明：バイト数に1,2,4の何れかを指定して、変数を確保し、初期値を
代入する。以降、戻り値のハンドルを使用して、値を読み書き
出来る。
確保されるメモリ領域は内部でunsignedで扱われる。この値は
なでしこ側から見るとグローバルな領域になるので、関数内等
ローカルスコープから本関数をコールした場合も、変数自体は
グローバルに確保されていることに注意すること（つまり、
なでしこの関数を抜けても、変数領域は解放されない）。
確保が成功した場合には0以上の整数が、失敗した場合には-1
が返される。使用が終了した場合はハンドルを解放すること。
・バイト読込
書式：バイト読込（[int]ハンドル)
戻値：[int]変数値
説明：バイト確保命令で取得したハンドルの、現在の値を取得する。
戻り値は整数型になる。無効なハンドル値を指定した場合には
常に0が返される。
・バイト書込
書式：バイト書込（[int]ハンドル、[int]値）
戻値：[int]結果
説明：バイト確保命令で取得したハンドルに対して、指定した値を
書き込む。書き込める値の範囲は確保されている領域サイズに
より異なり、範囲外の値を指定した場合にはエラーとなる。
書込が成功した場合には0が、失敗した場合には-1が返される。
・バイト右シフト
書式：バイト書込（[int]ハンドル、[int]シフト量）
戻値：[int]結果
説明：ハンドルで確保されているバイトに対して、シフト量で指定
した分、右シフトを実施する。シフト量は確保されている
バイトのサイズにより、1byteの場合は7、2byteの場合は15、
4byteの場合は31となる。
成功した場合、シフト後の値が元の値に上書きされ、0が
返される。失敗した場合には-１が返される。
・バイト左シフト
書式：バイト書込（[int]ハンドル、[int]シフト量）
戻値：[int]結果
説明：ハンドルで確保されているバイトに対して、シフト量で指定
した分、左シフトを実施する。シフト量は確保されている
バイトのサイズにより、1byteの場合は7、2byteの場合は15、
4byteの場合は31となる。
成功した場合、シフト後の値が元の値に上書きされ、0が
返される。失敗した場合には-１が返される。
・エンディアン変換
書式：エンディアン変換（[int]ハンドル)
戻値：[int]結果
説明：バイト確保命令で取得したハンドルに対応する値のエンディアン
変換を実施する。変換後の値はハンドル対応値に上書きされる。
成功した場合は0が、無効なハンドルを指定した場合は-1が
返される。
------ここまで------
なでしこでは、その他現代風の高級言語（スクリプト、ですかね）
に似て、変数の型を指定しなくても関数の結果を受けられますが、
「整数」「数値」など指定することも可能です。
「整数」と言うとCで言うところのintで宣言されて、サイズ的には4byte
の空間（メモリ）が確保されている様です。
バイナリデータを扱う場合は、サイズとして1,2,4byteのデータを
意識的に確保して使用することが多いので、バッファと一部被る
部分はありますが「バイト確保」関数を準備しました。
バイト制御系の関数に限らず、このDLLでは「～確保」関数を
用いてDLL内で必要なメモリ等を確保してます。メモリや構造体を
そのままなでしこに渡すことは出来ないので、なでしこに対して
渡すのは「ハンドル」値です。これはなでしこで言うところの「整数」
です。以降、このDLLのその他の関数を使用して操作を行う
場合は、引数にこの「ハンドル」を指定します。
------ここから------
・バイト確保
書式：バイト確保（[int]バイト数、[int]初期値)
戻値：[int]ハンドル
説明：バイト数に1,2,4の何れかを指定して、変数を確保し、初期値を
代入する。以降、戻り値のハンドルを使用して、値を読み書き
出来る。
確保されるメモリ領域は内部でunsignedで扱われる。この値は
なでしこ側から見るとグローバルな領域になるので、関数内等
ローカルスコープから本関数をコールした場合も、変数自体は
グローバルに確保されていることに注意すること（つまり、
なでしこの関数を抜けても、変数領域は解放されない）。
確保が成功した場合には0以上の整数が、失敗した場合には-1
が返される。使用が終了した場合はハンドルを解放すること。
・バイト読込
書式：バイト読込（[int]ハンドル)
戻値：[int]変数値
説明：バイト確保命令で取得したハンドルの、現在の値を取得する。
戻り値は整数型になる。無効なハンドル値を指定した場合には
常に0が返される。
・バイト書込
書式：バイト書込（[int]ハンドル、[int]値）
戻値：[int]結果
説明：バイト確保命令で取得したハンドルに対して、指定した値を
書き込む。書き込める値の範囲は確保されている領域サイズに
より異なり、範囲外の値を指定した場合にはエラーとなる。
書込が成功した場合には0が、失敗した場合には-1が返される。
・バイト右シフト
書式：バイト書込（[int]ハンドル、[int]シフト量）
戻値：[int]結果
説明：ハンドルで確保されているバイトに対して、シフト量で指定
した分、右シフトを実施する。シフト量は確保されている
バイトのサイズにより、1byteの場合は7、2byteの場合は15、
4byteの場合は31となる。
成功した場合、シフト後の値が元の値に上書きされ、0が
返される。失敗した場合には-１が返される。
・バイト左シフト
書式：バイト書込（[int]ハンドル、[int]シフト量）
戻値：[int]結果
説明：ハンドルで確保されているバイトに対して、シフト量で指定
した分、左シフトを実施する。シフト量は確保されている
バイトのサイズにより、1byteの場合は7、2byteの場合は15、
4byteの場合は31となる。
成功した場合、シフト後の値が元の値に上書きされ、0が
返される。失敗した場合には-１が返される。
・エンディアン変換
書式：エンディアン変換（[int]ハンドル)
戻値：[int]結果
説明：バイト確保命令で取得したハンドルに対応する値のエンディアン
変換を実施する。変換後の値はハンドル対応値に上書きされる。
成功した場合は0が、無効なハンドルを指定した場合は-1が
返される。
------ここまで------
なでしこでは、その他現代風の高級言語（スクリプト、ですかね）
に似て、変数の型を指定しなくても関数の結果を受けられますが、
「整数」「数値」など指定することも可能です。
「整数」と言うとCで言うところのintで宣言されて、サイズ的には4byte
の空間（メモリ）が確保されている様です。
バイナリデータを扱う場合は、サイズとして1,2,4byteのデータを
意識的に確保して使用することが多いので、バッファと一部被る
部分はありますが「バイト確保」関数を準備しました。
バイト制御系の関数に限らず、このDLLでは「～確保」関数を
用いてDLL内で必要なメモリ等を確保してます。メモリや構造体を
そのままなでしこに渡すことは出来ないので、なでしこに対して
渡すのは「ハンドル」値です。これはなでしこで言うところの「整数」
です。以降、このDLLのその他の関数を使用して操作を行う
場合は、引数にこの「ハンドル」を指定します。
2013年8月12日月曜日
【なでしこ】プラグインを作ってみる ～設計編 その1～
では、自分用のプラグインを作ってみましょう！。前にも書きましたが、
なでしこはメモリ操作系の関数が殆どないので、なんとなくC言語っぽく
使える様に、次の様な関数を含むDLLを作ってみたいと思います。
■バイト制御
・バイト確保
・バイト読込
・バイト書込
・バイト右シフト
・バイト左シフト
・エンディアン変換
■メモリ（バッファ）制御
・バッファ確保
・バッファクリア
・バッファコピー
・バッファ読込
・バッファ書込
・バッファ比較
■メモリ（リングバッファ）制御
・リングバッファ確保
・リングバッファ読込
・リングバッファ書込
・リングバッファ読込サイズ
■リスト（キュー）制御
・キュー作成
・キュー追加
・キュー取得
・キュー要素数取得
■リスト（スタック）制御
・スタック作成
・スタック追加
・スタック取得
・スタック要素数取得
■ファイル（バイナリファイル）制御
・バイナリオープン
・バイナリ読込
・バイナリ書込
・バイナリシーク
・バイナリ位置取得
■ビット制御
・ビットチェック
・ビットセット
・ビットクリア
■ソケット制御
・ソケットオープン
・ソケット接続待ち
・ソケット接続
・ＴＣＰ送信
・ＴＣＰ受信
・ＵＤＰ送信
・ＵＤＰ受信
■シリアル制御
・シリアルオープン
・シリアル送信
・シリアル受信
■ハンドル制御
・ハンドル解放
・ハンドルタイプ取得
あれもこれも…と思ってたらちょっと欲張りすぎたかな(^^;。実際に
実装したときちょっと後悔したけど、まま大半は定型作業だから
ヨシとしよう。
次は関数の仕様をざっくり決めますよ！。それはまた次回。
なでしこはメモリ操作系の関数が殆どないので、なんとなくC言語っぽく
使える様に、次の様な関数を含むDLLを作ってみたいと思います。
■バイト制御
・バイト確保
・バイト読込
・バイト書込
・バイト右シフト
・バイト左シフト
・エンディアン変換
■メモリ（バッファ）制御
・バッファ確保
・バッファクリア
・バッファコピー
・バッファ読込
・バッファ書込
・バッファ比較
■メモリ（リングバッファ）制御
・リングバッファ確保
・リングバッファ読込
・リングバッファ書込
・リングバッファ読込サイズ
■リスト（キュー）制御
・キュー作成
・キュー追加
・キュー取得
・キュー要素数取得
■リスト（スタック）制御
・スタック作成
・スタック追加
・スタック取得
・スタック要素数取得
■ファイル（バイナリファイル）制御
・バイナリオープン
・バイナリ読込
・バイナリ書込
・バイナリシーク
・バイナリ位置取得
■ビット制御
・ビットチェック
・ビットセット
・ビットクリア
■ソケット制御
・ソケットオープン
・ソケット接続待ち
・ソケット接続
・ＴＣＰ送信
・ＴＣＰ受信
・ＵＤＰ送信
・ＵＤＰ受信
■シリアル制御
・シリアルオープン
・シリアル送信
・シリアル受信
■ハンドル制御
・ハンドル解放
・ハンドルタイプ取得
あれもこれも…と思ってたらちょっと欲張りすぎたかな(^^;。実際に
実装したときちょっと後悔したけど、まま大半は定型作業だから
ヨシとしよう。
次は関数の仕様をざっくり決めますよ！。それはまた次回。
2013年8月9日金曜日
【なでしこ】プラグインをMS VC++ Express(2010)で作成する
仕事が休みの日にしか書かないので非常に気まぐれな更新ですが、
ボチボチやっていきましょうか！。
さて、なでしこのプラグインを作ろうと思っても、実際あまり情報がない
訳ですよ。Google先生に聞いてみると、Google Codeのなでしこリポジトリ
に、ソースコード一式がありましたが、どうやらこれはVC++用ではない
様子。でも、これを元にして作れそうですよ。
ってことで、まずMSのサイトからVC++ Express 2010をダウンロード
してきます →こちら
2012もリリースされてますが、必要なのはVC++だけなので、2010を
使用します。で、VC++用のプロジェクトを作成したので一式を
公開します →こちら
上記のリンクを辿るとbase.7zを取得できます。これを解凍すると、
以下の様なファイルとディレクトリが作成されます。
\base
| debug.c
| dnako_import.c
| dnako_import.h
| dnako_import_def.h
| dnako_import_types.c
| dnako_import_types.h
| dnako_plugin_body.c
| ReadMe.txt
|
\---nako_dll_base
dnako_import.def
nako_dll_base.sln
nako_dll_base.vcxproj
VC++が入っていれば\nako_dll_base\nako_dll_base.slnを実行
すると、VC++が起動しますので、このままコンパイルすれば
サンプルDLLが出切るハズ（何も設定しない状態では\nako_dll_base\Debug
の下にDLLが出来ます）。これをなでしこのプラグインフォルダに
コピーすれば使用できます。名前を変えたい場合は、VC++の
プロジェクトオプションを変更してください。
尚ソースコードは、上記なでしこのGoogle Codeサイトから
取得したものを若干変更してありますのであしからず。
（主にエラー処理とか、関数内で"#include呼んでファイル展開
してたのを修正とか、その程度です）。
これでだれでもDLLが作れる様になりますね！ヽ(￣▽￣)ノ。
でももうちょっと複雑な関数を実装したサンプルがあっても良さ
そうなので、実際にこれをベースにして何か作ってみようかと
思います。それはまた次回♪
ボチボチやっていきましょうか！。
さて、なでしこのプラグインを作ろうと思っても、実際あまり情報がない
訳ですよ。Google先生に聞いてみると、Google Codeのなでしこリポジトリ
に、ソースコード一式がありましたが、どうやらこれはVC++用ではない
様子。でも、これを元にして作れそうですよ。
ってことで、まずMSのサイトからVC++ Express 2010をダウンロード
してきます →こちら
2012もリリースされてますが、必要なのはVC++だけなので、2010を
使用します。で、VC++用のプロジェクトを作成したので一式を
公開します →こちら
上記のリンクを辿るとbase.7zを取得できます。これを解凍すると、
以下の様なファイルとディレクトリが作成されます。
\base
| debug.c
| dnako_import.c
| dnako_import.h
| dnako_import_def.h
| dnako_import_types.c
| dnako_import_types.h
| dnako_plugin_body.c
| ReadMe.txt
|
\---nako_dll_base
dnako_import.def
nako_dll_base.sln
nako_dll_base.vcxproj
VC++が入っていれば\nako_dll_base\nako_dll_base.slnを実行
すると、VC++が起動しますので、このままコンパイルすれば
サンプルDLLが出切るハズ（何も設定しない状態では\nako_dll_base\Debug
の下にDLLが出来ます）。これをなでしこのプラグインフォルダに
コピーすれば使用できます。名前を変えたい場合は、VC++の
プロジェクトオプションを変更してください。
尚ソースコードは、上記なでしこのGoogle Codeサイトから
取得したものを若干変更してありますのであしからず。
（主にエラー処理とか、関数内で"#include呼んでファイル展開
してたのを修正とか、その程度です）。
これでだれでもDLLが作れる様になりますね！ヽ(￣▽￣)ノ。
でももうちょっと複雑な関数を実装したサンプルがあっても良さ
そうなので、実際にこれをベースにして何か作ってみようかと
思います。それはまた次回♪
2013年8月4日日曜日
【なでしこ】できること、できないこと
なでしこの命令一覧 を見てると分かりますが、日常の定型作業などを
行うには使い易い言語です。ちょこちょっと書いて動かすのがいい感じ
ですかね～(^^)。
扱えるデータの種類としては、大体のモノは扱えますが、メインターゲットは
「文字列」な感じです。ファイルにしてもテキストファイルは非常に扱い易い。
ただ、組み込みとか通信系のプログラマな自分にからすると、バイナリ系が
非常に扱いにくい（￣へ￣；。
以前に一度RS232C（シリアル通信）を使うプログラムを組もうとして、バイナリ
データが扱えなくて諦めた経緯があります。またTCP/IPとかはソケットで
扱えると便利なんだけど…そのAPIも今のところありません。
ファイル用のAPIも揃ってはいますが、Cをメインで使ってる自分としては
ANSIっぽいAPIが欲しいな～と思うわけです。
データは配列など一通り揃ってますが、メモリとして扱うにはちょっと
難しいかな…と言うことで、なかなかC言語な頭では使いにくい部分も
あり、こりゃ一筋縄で行かないなあ(￣ω￣;。
しかし！、なでしこには「プラグイン」と言う優れた仕組みが備わっていて
自分でプラグイン作ればAPIを追加できますよ！。と、いう事でサクッと
プラグインを作ってみたいと思います。
行うには使い易い言語です。ちょこちょっと書いて動かすのがいい感じ
ですかね～(^^)。
扱えるデータの種類としては、大体のモノは扱えますが、メインターゲットは
「文字列」な感じです。ファイルにしてもテキストファイルは非常に扱い易い。
ただ、組み込みとか通信系のプログラマな自分にからすると、バイナリ系が
非常に扱いにくい（￣へ￣；。
以前に一度RS232C（シリアル通信）を使うプログラムを組もうとして、バイナリ
データが扱えなくて諦めた経緯があります。またTCP/IPとかはソケットで
扱えると便利なんだけど…そのAPIも今のところありません。
ファイル用のAPIも揃ってはいますが、Cをメインで使ってる自分としては
ANSIっぽいAPIが欲しいな～と思うわけです。
データは配列など一通り揃ってますが、メモリとして扱うにはちょっと
難しいかな…と言うことで、なかなかC言語な頭では使いにくい部分も
あり、こりゃ一筋縄で行かないなあ(￣ω￣;。
しかし！、なでしこには「プラグイン」と言う優れた仕組みが備わっていて
自分でプラグイン作ればAPIを追加できますよ！。と、いう事でサクッと
プラグインを作ってみたいと思います。
【なでしこ】プログラミング言語「なでしこ」
「なでしこ」と言うプログラミング言語があります。この言語は日本語でプログラミング
できます！。素晴らしい(^^)。個人的にはCなどでもプログラムできますが、面白そう
なので「なでしこ」やってみようかな～。
で、まずは「なでしこ」の本体を取得します。→こちら。
なでしこはインタプリタ型の言語なので、あまり高速な処理速度は望めませんが、
VC++とか使うこと考えたらお手軽♪。GUIの簡易RADもついてますし、なかなか
楽しめそうです（正直、この簡易RADがついてるのが一番の魅力(ё∇ё) ）。
あと、参考書としてはAmazonでも何冊か出てますが、上記のホームページや
こちら で入手可能なPDFを読めば、大体の扱い方は分かると思います。まずは
いじって楽しむのが一番ですかね～。
できます！。素晴らしい(^^)。個人的にはCなどでもプログラムできますが、面白そう
なので「なでしこ」やってみようかな～。
で、まずは「なでしこ」の本体を取得します。→こちら。
なでしこはインタプリタ型の言語なので、あまり高速な処理速度は望めませんが、
VC++とか使うこと考えたらお手軽♪。GUIの簡易RADもついてますし、なかなか
楽しめそうです（正直、この簡易RADがついてるのが一番の魅力(ё∇ё) ）。
あと、参考書としてはAmazonでも何冊か出てますが、上記のホームページや
こちら で入手可能なPDFを読めば、大体の扱い方は分かると思います。まずは
いじって楽しむのが一番ですかね～。
登録:
投稿 (Atom)