5.1.4　関数

(a)　オートロード機能の使用例（typeset -fuコマンドを使用した場合）

typeset -fuコマンドを使用した関数のオートロード機能の使用例を次に示します。なお，JP1/Advanced Shellではtypeset -fuコマンドのエイリアスとしてautoloadを提供しています。この例では関数auto1，関数auto2，関数auto3に対してオートロード機能を実行しています。

関数定義ファイル（/home/jp1as/autoload/auto1）の内容

0001 : function auto1 {                      # 関数auto1の定義
0002 :  echo "start auto1 in FPATH file"
0003 :  return 11
0004 : }

関数定義ファイル（/home/jp1as/autoload/auto2）の内容

0001 : autoxx() {          # 関数autoxxの定義(auto2は定義しない)
0002 :   echo "start autoxx in FPATH file"
0003 :   return 255
0004 : }

/home/jp1as/autoloadディレクトリの関数定義ファイル

auto1

auto2

（関数定義ファイル「auto3」は存在しない）

ジョブ定義スクリプト（/home/jp1as/test.ash）の内容

0001 : export FPATH="/home/jp1as/autoload"     # FPATHの設定
0002 :
0003 : typeset -fu auto1 auto2  # 関数auto1,auto2にオートロード機能を適用
0004 : autoload auto3           # 関数auto3にオートロード機能を適用
0005 :
0006 : auto1                    # 関数auto1を実行
0007 : auto2                    # 関数auto2を実行
0008 : auto3                    # 関数auto3を実行

実行結果

********  ジョブコントローラのメッセージ出力  ********
14:40:16 152262 KNAX0091-I ADSH152262 ジョブが開始しました。
14:40:16 152262 KNAX7901-I ジョブコントローラは，ジョブ終了時にすべての非同期実行プロセスの完了を待ちます。
14:40:16 152262 KNAX7902-I ジョブコントローラは，"端末入力モード"で動作します。
14:40:16 152262 KNAX6112-I コマンド（export, 行番号=1）が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
14:40:16 152262 KNAX6112-I コマンド（typeset, 行番号=3）が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
14:40:16 152262 KNAX6112-I コマンド（typeset, 行番号=4）が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
14:40:16 152262 KNAX6112-I コマンド（echo, 行番号=2）が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
14:40:16 152262 KNAX6112-I コマンド（return, 行番号=3）が正常終了しました。rc=11 E-Time=0.000s C-Time=0.000s
14:40:16 152262 KNAX6046-E 関数（"auto2"）が関数定義ファイル（"/home/jp1as/autoload/auto2"）内に定義されていません。filename="/home/jp1as/test.ash" line=7
14:40:16 152262 KNAX6044-E FPATHシェル変数に指定されたディレクトリに関数（"auto3"）の定義ファイルが見つかりません。filename="/home/jp1as/test.ash" line=8
14:40:16 152262 KNAX0101-E ADSH152262 ジョブを実行中にエラーが発生しました。
14:40:16 152262 KNAX0098-I ADSH152262 ジョブが終了しました。rc=127 E-Time=0.003s C-Time=0.000s

注※1

関数auto1の実行結果が正常終了であることを示します。

注※2

関数auto2は，FPATHに指定されたディレクトリに同名の関数定義ファイルが存在していますが，その関数定義ファイルに関数auto2の定義がないため，KNAX6046-Eメッセージを出力しエラー終了します。

注※3

関数auto3は，FPATHに指定されたディレクトリに同名の関数定義ファイルが存在しないため，KNAX6044-Eメッセージを出力しエラー終了します。

(b)　注意事項

• オートロード機能で関数定義ファイルを読み込んで定義された関数は，それ以降，同じファイル名の関数定義ファイルを読み込みません。ただし，unsetコマンドで無効化したあとに関数を再実行した場合は，同名の関数定義ファイルを読み込みます。

• オートロード機能を有効にした関数であっても，すでに同一シェルスクリプト内，.（ドット）コマンドで呼び出したシェルスクリプト内，またはスクリプト拡張コマンド#-adsh_scriptで呼び出したシェルスクリプト内で定義済みであれば，関数定義ファイルを読み込みません。

• 同名の関数を異なる関数定義ファイルに定義した場合，あとで定義された関数が有効になります。関数定義ファイルに複数の関数を定義する場合は，関数名が重複していないか確認してください。

  関数「fn1」を異なる関数定義ファイルに定義した例と，その場合の出力結果を次に示します。

  関数定義ファイル（/home/jp1as/autoload/fn1）の内容

  0001 : fn1(){　　　　　　　　　　　　# 関数fn1の定義1
  0002 :   echo "start fn1"
  0003 :   return 1
  0004 : }

  関数定義ファイル（/home/jp1as/autoload/fn2）の内容

  0001 : fn2(){　　　　　　　　　　　　# 関数fn2の定義
  0002 :   echo "start fn2"
  0003 :   return 2
  0004 : }
  0005 : fn1(){　　　　　　　　　　　　# 関数fn1の定義2
  0006 :   echo "start fn1 in fn2"
  0007 :   return 21
  0008 : }

  ジョブ定義スクリプト（/home/jp1as/test.ash）の内容

  0001 : export FPATH="/home/jp1as/autoload"　# FPATHの設定
  0002 : typeset -fu fn1 fn2　　　　　　　　　# 関数fn1,fn2のオートロード機能を有効にする
  0003 : fn1　　　　　　　　　　　　　　　　　# 関数fn1を実行
  0004 : fn2　　　　　　　　　　　　　　　　　# 関数fn2を実行
  0005 : fn1　　　　　　　　　　　　　　　　　# 関数fn1を再度実行

  標準出力への出力結果

  start fn1　　　　　　　　　　　　　←定義1のfn1が実行されます
  start fn2
  start fn1 in fn2　　　　　　　　　　←定義2のfn1が実行されます

• 定義されていない関数に対して，オートロード機能を有効にした場合，関数定義ファイルが読み込まれるまで未定義状態となります。そのため，CUIデバッガのinfo functionsコマンドで表示されません。