External Interfaces/API

Description of Function pb_add

1. Input the Entry to Add

The pb_add function takes one argument, the Properties object pb_htable. pb_add uses disp to prompt for an entry. Using the up-arrow (^) character as a line delimiter, input inputs a name to the variable entry. Then, within a while loop, it uses input to get another line of the entry into variable line. If the line is empty, indicating that the user has finished the entry, the code breaks out of the while loop. If the line is not empty, the else statement appends line to entry and then appends the line delimiter. At the end, the strcmp checks the possibility that no input was entered and, if that is the case, returns.

• 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. Add the Entry to the Phone Book

After the input has completed, pb_add calls put on pb_htable with the hash key name (on which pb_keyfilter is called to change spaces to underscores) and entry. It then displays a message that the entry has been added.

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

Description of Function pb_lookup

Description of Function pb_remove