FP_SD_READ_LINE

SDカード指定ファイルからの1行読み出し

このFP命令は、s_FullFileNameで指定したファイルのd2_dutReadLineで指定したポインタ位置から、指定した読み出しバイト数まで、または改行文字(CR、LF、CR+LF)を検出するまで読み出します。結果は、d1_Outで指定したエリアに格納されます。

パラメータ

入力

s_FullFileName (STRING): ファイル名

入出力

d2_dutReadLine (FP_SD_READ_LINE_DUT): ポインタ位置と最大読み出し文字数

出力

d1_Out (STRING): 出力エリア

解説

SDメモリカード命令の概要の注意点もご参照ください。
SDメモリアクセス実行中フラグ(sys_bIsSDMemoryAccessActive)は、SDメモリカード命令の実行条件ENがTRUEになった後TRUEに変わり、命令の実行が完了するまでTRUEのままです。この間、他のSDメモリーカード命令を実行することはできません。
SDメモリアクセス完了フラグ(sys_blsSDMemoryAccessDone)は、命令が実行されるとFALSEに変わり、命令が完了したときTRUEに変わり、そのままTRUEになります。
命令の実行が完了するまで、出力エリアからデータを読み出さないでください。
FP_SD_READ_LINE_DUT,のuiMaxCharsToReadで指定された読み込みバイト数が、d1_Outにおける出力変数の最大文字長を超えないようにしてください。越えた場合、意図しない変数が上書きされ、演算エラーが発生することがあります。

エラーフラグ

sys_bIsSDMemoryAccessError

FALSE: 命令が正常完了したとき
TRUE: 命令が異常完了したとき
sys_iSDMemoryAccessErrorCodeを使用して、エラーコードを確認します。

sys_bIsOperationErrorHold (TRUEになり、TRUEを保持)

インデックス修飾時にエリアを超えたとき

sys_bIsOperationErrorNonHold (1回のスキャンに対してTRUE)

インデックス修飾時にエリアを超えたとき

例

POUヘッダ

POUヘッダには、このプログラムで使用するすべての入力変数と出力変数を宣言します。 POUヘッダは全プログラム言語で使用できます。

	VAR
		bStart: BOOL:=FALSE;
		dutReadLine: FP_SD_READ_LINE_DUT;
		sLineRead: STRING[32]:='';
	END_VAR

POUボディ

変数bStartがFALSEからTRUEに変化すると、このファンクションが実行されます。

LDボディ

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,4,2,6,4,R);
B(B_F,E_MOVE!,,26,1,32,5,,?DEN?D?AENO?C);
B(B_VARIN,,sLineRead,12,3,14,5,);
B(B_F,MAX_LEN!,,14,3,20,5,,?D?C);
B(B_F,TO_UINT!,,20,3,26,5,,?D?C);
B(B_VAROUT,,dutReadLine.uiMaxCharsToRead,32,3,34,5,);
L(1,0,1,5);
L(1,3,4,3);
L(6,3,26,3);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,4,1,6,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,12,1,14,3,N);
B(B_F,FP_SD_READ_LINE!,,26,0,41,5,,?DEN?Ds_FullFileName?Dd2_dutReadLine?Ad2_dutReadLine?AENO?Cd1_Out);
B(B_VARIN,,'\TestLine.csv',24,2,26,4,);
B(B_VAROUT,,sLineRead,41,2,43,4,);
B(B_VARIN,,dutReadLine,24,3,26,5,);
L(1,0,1,5);
L(1,2,4,2);
L(6,2,12,2);
L(14,2,26,2);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

STボディ

IF DF(bStart) AND NOT sys_bIsSDMemoryAccessActive then

		dutSDReadString.uiMaxCharsToRead := TO_UINT(MAX_LEN(sStringRead1));
		FP_SD_READ_LINE(s_FullFileName := '\TestLine.csv',
						d2_dutReadLine := dutSDReadString,
						d1_Out => sStringRead1);

END_IF;