raplist.h
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:5k
源码类别:

通讯编程

开发平台:

Visual C++

  1. /* -*- Mode:C++; c-basic-offset:8; tab-width:8; indent-tabs-mode:t -*- */
  2. /*
  3.  * Copyright (c) 1993 Regents of the University of California.
  4.  * All rights reserved.
  5.  *
  6.  * Redistribution and use in source and binary forms, with or without
  7.  * modification, are permitted provided that the following conditions
  8.  * are met:
  9.  * 1. Redistributions of source code must retain the above copyright
  10.  *    notice, this list of conditions and the following disclaimer.
  11.  * 2. Redistributions in binary form must reproduce the above copyright
  12.  *    notice, this list of conditions and the following disclaimer in the
  13.  *    documentation and/or other materials provided with the distribution.
  14.  * 3. All advertising materials mentioning features or use of this software
  15.  *    must display the following acknowledgement:
  16.  * This product includes software developed by the Computer Systems
  17.  * Engineering Group at Lawrence Berkeley Laboratory.
  18.  * 4. Neither the name of the University nor of the Laboratory may be used
  19.  *    to endorse or promote products derived from this software without
  20.  *    specific prior written permission.
  21.  *
  22.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32.  * SUCH DAMAGE.
  33.  *
  34.  * Author:
  35.  *   Mohit Talwar (mohit@catarina.usc.edu)
  36.  *
  37.  * $Header: /cvsroot/nsnam/ns-2/rap/raplist.h,v 1.4 2005/09/18 23:33:34 tomh Exp $
  38.  * 
  39.  * This is taken from UCB Nachos project
  40.  * 
  41.  * list.h 
  42.  *      Data structures to manage LISP-like lists.  
  43.  *
  44.  *      As in LISP, a list can contain any type of data structure
  45.  *      as an item on the list: IP addresses, pending interrupts etc.  
  46.  *      That is why each item is a "void *", or in other words, 
  47.  *      a "pointers to anything".
  48.  */
  49. #ifndef RAPLIST_H
  50. #define RAPLIST_H
  51. typedef void (*VoidFunctionPtr)(long arg); 
  52. typedef int (*CompareFunction)(void *item, void *key);
  53.  
  54. // The following class defines a "List element" -- which is
  55. // used to keep track of one item on a List.  It is equivalent to a
  56. // LISP cell, with a "car" ("next") pointing to the next element on the List,
  57. // and a "cdr" ("item") pointing to the item on the List.
  58. class ListElement 
  59. {
  60. public:
  61.   ListElement(void *itemPtr, float sortKey); // initialize a List element
  62.   
  63.   ListElement *next; // next element on List, 
  64.                                 // NULL if this is the last
  65.   float key;      // priority (+ve), for a sorted List
  66. // identification, for some
  67.   void *item; // pointer to item on the List
  68. };
  69. // The following class defines a "List" -- a singly linked List of
  70. // List elements, each of which points to a single item on the List.
  71. //
  72. // By using the "Sorted" functions, the List can be kept in sorted
  73. // in increasing order by "key" in ListElement.
  74. class List 
  75. {
  76. public:
  77.   List(); // Initialize the List
  78.   ~List(); // Deallocate the List
  79.   
  80.   void Prepend(void *item);  // Put item at the beginning of the List
  81.   void Append(void *item);  // Put item at the end of the List
  82.   void *Remove();    // Take item off the front of the List
  83.   
  84.   void Mapcar(VoidFunctionPtr func); // Apply "func" to every element 
  85.                                      // on the List
  86.   int IsEmpty(); // Is the List empty? 
  87.   int Size() {return size;} // Return the number of elements
  88.   // Routines to put/get items on/off List in order (sorted by key)
  89.   void SortedInsert(void *item, float sortKey); // Put item into List
  90.   void *SortedRemove(float *keyPtr);     // Remove first item from List
  91.   float MinKey();                 // sortKey of item at front
  92.   // Routines to put/get items on/off a Set
  93.   int SetInsert(void *key, CompareFunction eq);   // Put key into set
  94.   void *SetRemove(void *key, CompareFunction eq);  // Remove key from set
  95.   void *IsPresent(void *key, CompareFunction eq);  // Is key there in set
  96.   void Purge(void *key, CompareFunction eq, VoidFunctionPtr destroy);
  97.   
  98. private:
  99.   ListElement *first;           // Head of the List, NULL if List is empty
  100.   ListElement *last; // Last element of List
  101.   int size; // Number of elements in the List 
  102. };
  103. #endif // RAPLIST_H