lib/freelist.js

   1 // Copyright Joyent, Inc. and other Node contributors.
   2 //
   3 // Permission is hereby granted, free of charge, to any person obtaining a
   4 // copy of this software and associated documentation files (the
   5 // "Software"), to deal in the Software without restriction, including
   6 // without limitation the rights to use, copy, modify, merge, publish,
   7 // distribute, sublicense, and/or sell copies of the Software, and to permit
   8 // persons to whom the Software is furnished to do so, subject to the
   9 // following conditions:
  10 //
  11 // The above copyright notice and this permission notice shall be included
  12 // in all copies or substantial portions of the Software.
  13 //
  14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  15 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
  17 // NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
  18 // DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  19 // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  20 // USE OR OTHER DEALINGS IN THE SOFTWARE.
  21
  22 // This is a free list to avoid creating so many of the same object.
  23 exports.FreeList = function(name, max, constructor) {
  24   this.name = name;
  25   this.constructor = constructor;
  26   this.max = max;
  27   this.list = [];
  28 };
  29
  30
  31 exports.FreeList.prototype.alloc = function() {
  32   //debug("alloc " + this.name + " " + this.list.length);
  33   return this.list.length ? this.list.shift() :
  34                             this.constructor.apply(this, arguments);
  35 };
  36
  37
  38 exports.FreeList.prototype.free = function(obj) {
  39   //debug("free " + this.name + " " + this.list.length);
  40   if (this.list.length < this.max) {
  41     this.list.push(obj);
  42     return true;
  43   }
  44   return false;
  45 };