5.5.3　関数情報配列

(1)　関数情報配列の種類

関数情報配列には次の表に示す種類があります。

注※1

シグナルや強制終了要求を受けたときにtrapアクション内で関数を呼び出した場合，関数呼び出し行番号配列には，trapアクション内ではなく，trapアクションを呼び出した処理の行番号が格納されます。

例えば，次の定義では行番号4で関数fn1を呼び出していますが，行番号4はtrapアクション内のため，行番号6が配列に格納されます。

1  fn1(){
2    echo ${ADSH_LINENO[*]}
3  }
4  trap fn1 INT
5
6  kill -INT $$
7  pwd

注※2

adshexecコマンドを-rオプションで実行した場合，関数定義スクリプトファイル名配列のスクリプトファイル名には「-r CMDLINE」が格納されます。例を次に示します。

C:\tmp>adshexec -m SIMPLE -r "echo ${ADSH_SOURCE[*]}"
-r CMDLINE
 
C:\tmp>

ページの先頭へ

(2)　関数情報配列の構造

次のジョブ定義スクリプト（ファイル名：func.ash）を例に，配列の遷移について説明します。

1    fn3(){
2      echo "JP1/AS"
3    }
4    fn2(){
5      fn3
6    }
7    fn1(){
8      fn2
9    }
10   fn1

このジョブ定義スクリプトを実行すると，配列の状態は関数fn3の実行によって次の図のように遷移します。

ページの先頭へ

(3)　関数情報配列に関する注意事項

• 関数情報配列はジョブ定義スクリプト内で変更できません。そのため，CUIやGUIでのデバッグ時は，値の参照（watch，print，およびinfo variablesコマンド）はできますが，更新（setコマンド）はできません。

• 関数情報配列をエクスポートすると，次のように動作します。

  • 配列ではなく，変数として要素0の内容が引き継がれます。ただし，関数情報配列はジョブ起動時に再設定されるため，子孫ジョブの場合は上書きされてしまいます。

  • 子孫ジョブの稼働実績情報には，上書き前のエクスポートされた値が出力されます。

• #-adsh_step_startコマンドのstepVar属性には，関数情報配列の名称は指定できません。指定するとKNAX6312-Eメッセージを出力してエラー終了します。

• 【Windows版限定】関数定義スクリプトファイル名配列には「\」を含むスクリプトファイルの絶対パスが格納されます。echoコマンド，printコマンドではシェル変数展開後の「\」をエスケープ文字として扱います。そのため，echoコマンド，printコマンドで関数定義スクリプトファイル名配列の値を出力する場合は，次のように指定し実行してください。

  • echoコマンドで出力する場合は-Eオプションを指定するか，または環境設定パラメーターESCAPE_SEQ_ECHO_DEFAULTにNOを指定してください。

  • printコマンドで出力する場合は-rオプションを指定してください。

ページの先頭へ