論理値の読み込み (Scilabゲートウェイ) 論理値の行列を読み込む方法.

## 呼び出し手順

入力引数プロファイル:

    SciErr getMatrixOfBoolean(void* _pvCtx, int* _piAddress, int* _piRows, int* _piCols, int** _piBool)

名前指定変数プロファイル:

    SciErr readNamedMatrixOfBoolean(void* _pvCtx, const char* _pstName, int* _piRows, int* _piCols, int* _piBool)

## 引数

_pvCtx

  Scilab環境ポインタ, api_scilab.h により定義された "pvApiCtx"で指定.

_piAddress

  Scilab変数のアドレス.

_pstName

  "名前指定"関数の場合の変数名.

_piRows

  変数の行数を返す.

_piCols

  変数の列数を返す.

_piBool

  データ配列のアドレスを返す (大きさ: _iRows * _iCols). "名前指定"関数の場合, _piBool は関数をコールする前に メモリを確保しておく必要があります.

SciErr

  エラー構造体で,エラーメッセージ履歴と最初のエラー番号を格納します.

## 説明

このヘルプは論理値の行列を読み込む方法を説明します.

## ゲートウェイのソース

    #include "api_scilab.h"
    int read_write_boolean(char *fname,void* pvApiCtx)
    {
        SciErr sciErr;
        int i;
        // 最初の変数の情報 : doubleの実数行列
        int iRows       = 0;
        int iCols       = 0;
        int *piAddr     = NULL;
        int* piBool     = NULL;
        // 入力/出力引数を確認
        CheckInputArgument(pvApiCtx, 1,1);
        CheckOutputArgument(pvApiCtx, 0,1);
        // 最初の引数の変数アドレスを取得
        sciErr = getVarAddressFromPosition(pvApiCtx, 1, &piAddr);
        if(sciErr.iErr)
        {
            printError(&sciErr, 0);
            return 0;
        }
        // Scilabメモリから大きさとデータを取得
        sciErr = getMatrixOfBoolean(pvApiCtx, piAddr, &iRows, &iCols, &piBool);
        if(sciErr.iErr)
        {
            printError(&sciErr, 0);
            return 0;
        }
        // データ処理を行う
        for(i = 0 ; i < iRows * iCols ; i++)
        {
            piBool[i] = piBool[i] == 0 ? 1 : 0;
        }
        sciErr = createMatrixOfBoolean(pvApiCtx, nbInputArgument(pvApiCtx) + 1, iRows, iCols, piBool);
        if(sciErr.iErr)
        {
            printError(&sciErr, 0);
            return 0;
        }
        AssignOutputVariable(pvApiCtx, 1) = nbInputArgument(pvApiCtx) + 1;
        return 0;
    }

## Scilab テストスクリプト

    a = [%t, %f, %t ; %f, %t, %f ; %t, %f, %t];
    a_ref = [%f, %t, %f ; %t, %f, %t ; %f, %t, %f];
    b = read_write_boolean(a);
    if or(b <> a_ref) then error("failed"), end