ACE/apps/drwho/BS_Server.h

   1 /* -*- C++ -*- */
   2
   3 //=============================================================================
   4 /**
   5  *  @file    BS_Server.h
   6  *
   7  *  Provides the server's binary search lookup table abstraction.
   8  *
   9  *  @author Douglas C. Schmidt
  10  */
  11 //=============================================================================
  12
  13
  14 #ifndef _BS_SERVER_H
  15 #define _BS_SERVER_H
  16
  17 #include "Binary_Search.h"
  18
  19 /**
  20  * @class BS_Server
  21  *
  22  * @brief Provides the server's binary search lookup table abstraction.
  23  */
  24 class BS_Server : public Binary_Search
  25 {
  26 public:
  27   // = Initialization.
  28   BS_Server (const char *packet);
  29
  30   /**
  31    * This function is used to merge the <key_name> from server
  32    * <host_name> into the sorted list of userids kept on the client's
  33    * side.
  34    */
  35   virtual Protocol_Record *insert (const char *key_name,
  36                                    int max_len = MAXUSERIDNAMELEN);
  37
  38   /**
  39    * An iterator, similar to Binary_Search::get_next_friend, though in
  40    * this case the friend records are returned in the order they
  41    * appeared in the friend file, rather than in sorted order.  Also,
  42    * we skip over entries that don't have any hosts associated with
  43    * them.
  44    */
  45   virtual Protocol_Record *get_next_entry ();
  46 };
  47
  48 #endif /* _BS_SERVER_H */