外部インタフェース/API

関数pb_addの説明

1. エントリを追加のために入力

関数pb_addは、1つの引数、Propertiesオブジェクトpb_htableを受け取ります。pb_addは、dispを使ってエントリの入力を指示します。上向き矢印 (^) キャラクタをラインデリミタとして使って、inputは名前を変数entryに入力します。その後、 whileループ内で、inputを使ってエントリの別の行を変数lineに取り込みます。エントリが終了したことを示す行が空の場合は、コードはwhileループから出ます。行が空でない場合は、elseステートメントは、エントリに行を追加し、その後ラインデリミタを追加します。最後にstrcmpはinputが入力されなかった可能性をチェックし、その場合はりターンします。

function pb_add(pb_htable)
disp 'Type the name for the new entry, followed by Enter.'
disp 'Then, type the phone number(s), one per line.'
disp 'To complete the entry, type an extra Enter.'
name = input(':: ','s');
entry=[name '^'];
while 1
    line = input(':: ','s');
    if isempty(line)
        break;
    else
        entry=[entry line '^'];
    end;
end;

if strcmp(entry, '^')
    disp 'No name entered'
    return;
end;

2. 電話帳にエントリを追加

入力が完了した後で、pb_addは、ハッシュキーname(空白をアンダースコアに変更するためにpb_keyfilterが呼び出されます)とentryを使って、pb_htableについてputを呼び出します。その後、エントリが追加されたことを示すメッセージが表示されます。

pb_htable.put(pb_keyfilter(name),entry);
disp ' '
disp(sprintf('%s has been added to the phone book.', name));

関数pb_lookupの説明

関数pb_removeの説明