splaytree.c
上传用户:kjfoods
上传日期:2020-07-06
资源大小:29949k
文件大小:19k
源码类别:

midi

开发平台:

Unix_Linux

  1. /*****************************************************************************
  2.  * splaytree.c:
  3.  *****************************************************************************
  4.  * Copyright (C) 2004 the VideoLAN team
  5.  * $Id: 5049cf4ff76de265e060c4ff91b45ef3b7b179a8 $
  6.  *
  7.  * Authors: Cyril Deguet <asmax@videolan.org>
  8.  *          code from projectM http://xmms-projectm.sourceforge.net
  9.  *
  10.  * This program is free software; you can redistribute it and/or modify
  11.  * it under the terms of the GNU General Public License as published by
  12.  * the Free Software Foundation; either version 2 of the License, or
  13.  * (at your option) any later version.
  14.  *
  15.  * This program is distributed in the hope that it will be useful,
  16.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.  * GNU General Public License for more details.
  19.  *
  20.  * You should have received a copy of the GNU General Public License
  21.  * along with this program; if not, write to the Free Software
  22.  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23.  *****************************************************************************/
  24. /*
  25.                 An implementation of top-down splaying
  26.                     D. Sleator <sleator@cs.cmu.edu>
  27.                           March 1992
  28.   "Splay trees", or "self-adjusting search trees" are a simple and
  29.   efficient data structure for storing an ordered set.  The data
  30.   structure consists of a binary tree, without parent pointers, and no
  31.   additional fields.  It allows searching, insertion, deletion,
  32.   deletemin, deletemax, splitting, joining, and many other operations,
  33.   all with amortized logarithmic performance.  Since the trees adapt to
  34.   the sequence of requests, their performance on real access patterns is
  35.   typically even better.  Splay trees are described in a number of texts
  36.   and papers [1,2,3,4,5].
  37.   The code here is adapted from simple top-down splay, at the bottom of
  38.   page 669 of [3].  It can be obtained via anonymous ftp from
  39.   spade.pc.cs.cmu.edu in directory /usr/sleator/public.
  40.   The chief modification here is that the splay operation works even if the
  41.   item being splayed is not in the tree, and even if the tree root of the
  42.   tree is NULL.  So the line:
  43.                               t = splay(i, t);
  44.   causes it to search for item with key i in the tree rooted at t.  If it's
  45.   there, it is splayed to the root.  If it isn't there, then the node put
  46.   at the root is the last one before NULL that would have been reached in a
  47.   normal binary search for i.  (It's a neighbor of i in the tree.)  This
  48.   allows many other operations to be easily implemented, as shown below.
  49.   [1] "Fundamentals of data structures in C", Horowitz, Sahni,
  50.        and Anderson-Freed, Computer Science Press, pp 542-547.
  51.   [2] "Data Structures and Their Algorithms", Lewis and Denenberg,
  52.        Harper Collins, 1991, pp 243-251.
  53.   [3] "Self-adjusting Binary Search Trees" Sleator and Tarjan,
  54.        JACM Volume 32, No 3, July 1985, pp 652-686.
  55.   [4] "Data Structure and Algorithm Analysis", Mark Weiss,
  56.        Benjamin Cummins, 1992, pp 119-130.
  57.   [5] "Data Structures, Algorithms, and Performance", Derick Wood,
  58.        Addison-Wesley, 1993, pp 367-375.
  59.   The following code was written by Daniel Sleator, and is released
  60.   in the public domain. It has been heavily modified by Carmelo Piccione,
  61.   (cep@andrew.cmu.edu), to suit personal needs, 
  62. */
  63. #include <stdlib.h>
  64. #include <stdio.h>
  65. #include "common.h"
  66. #include "fatal.h"
  67. #include "splaytree_types.h"
  68. #include "splaytree.h"
  69. splaynode_t * splay (void * key, splaynode_t * t, int * match_type, int (*compare)());
  70. int free_splaynode(splaynode_t * splaynode, void (*free_key)());
  71. void splay_traverse_helper (void (*func_ptr)(), splaynode_t * splaynode);
  72. splaynode_t * splay_delete_helper(void * key, splaynode_t * t, int (*compare)(), void (*free_key)());
  73. void splay_find_above_min_helper(void * max_key, void ** closest_key, splaynode_t * root, int (*compare)());
  74. void splay_find_below_max_helper(void * max_key, void ** closest_key, splaynode_t * root, int (*compare)());
  75. splaynode_t * new_splaynode(int type, void * key, void * data);
  76. int splay_insert_node(splaynode_t * splaynode, splaytree_t * splaytree);
  77. int splay_rec_size(splaynode_t * splaynode);
  78. /* Creates a splay tree given a compare key function, copy key function, and free key function.
  79.    Ah yes, the wonders of procedural programming */
  80. splaytree_t * create_splaytree(int (*compare)(), void * (*copy_key)(), void (*free_key)()) {
  81.   splaytree_t * splaytree;
  82.   /* Allocate memory for the splaytree struct */
  83.   if ((splaytree = (splaytree_t*)malloc(sizeof(splaytree_t))) == NULL)
  84.     return NULL;
  85.   /* Set struct entries */
  86.   splaytree->root = NULL;
  87.   splaytree->compare = compare;
  88.   splaytree->copy_key = copy_key;
  89.   splaytree->free_key = free_key;
  90.   
  91.   /* Return instantiated splay tree */
  92.   return splaytree;
  93. }
  94. /* Destroys a splay tree */
  95. int destroy_splaytree(splaytree_t * splaytree) {
  96.   /* Null argument check */
  97.   if (splaytree == NULL)
  98.     return FAILURE;
  99.   /* Recursively free all splaynodes in tree */
  100.   free_splaynode(splaytree->root, splaytree->free_key);
  101.   /* Free the splaytree struct itself */
  102.   free(splaytree);
  103.   
  104.   /* Done, return success */
  105.   return SUCCESS;
  106. }
  107. /* Recursively free all the splaynodes */
  108. int free_splaynode(splaynode_t * splaynode, void (*free_key)()) {
  109.   /* Ok if this happens, a recursive base case */
  110.   if (splaynode == NULL)
  111.     return SUCCESS;
  112.   /* Free left node */
  113.   free_splaynode(splaynode->left, free_key);
  114.   
  115.   /* Free right node */
  116.   free_splaynode(splaynode->right, free_key);
  117.   
  118.   /* Free this node's key */
  119.   free_key(splaynode->key);
  120.   
  121.   /* Note that the data pointers are not freed here.
  122.      Should be freed with a splay traversal function */
  123.   
  124.   /* Free the splaynode structure itself */
  125.   free(splaynode);
  126.  
  127.   /* Finished, return success */
  128.   return SUCCESS;
  129. }
  130. /* Traverses the entire splay tree with the given function func_ptr */
  131. void splay_traverse(void (*func_ptr)(), splaytree_t * splaytree) {
  132.   /* Null argument check */
  133.   if (splaytree == NULL)
  134.     return; 
  135.   if (func_ptr == NULL)
  136. return;
  137.   
  138.   /* Call recursive helper function */
  139.   splay_traverse_helper(func_ptr, splaytree->root);
  140.   return;
  141. }
  142. /* Helper function to traverse the entire splaytree */
  143. void splay_traverse_helper (void (*func_ptr)(), splaynode_t * splaynode) {  
  144.   /* Normal if this happens, its a base case of recursion */
  145.   if (splaynode == NULL)
  146.     return;
  147.   /* Recursively traverse to the left */
  148.   splay_traverse_helper(func_ptr, splaynode->left);
  149.   
  150.   
  151.   /* Node is a of regular type, so its ok to perform the function on it */
  152.   if (splaynode->type == REGULAR_NODE_TYPE)
  153.    func_ptr(splaynode->data);
  154.   
  155.   /* Node is of symbolic link type, do nothing */
  156.   else if (splaynode->type == SYMBOLIC_NODE_TYPE)
  157. ;
  158.   
  159.   /* Unknown node type */
  160.   else
  161.     ;
  162.   
  163.   /* Recursively traverse to the right */
  164.   splay_traverse_helper(func_ptr, splaynode->right);
  165.   /* Done */
  166.   return;
  167. }
  168. /* Find the node corresponding to the given key in splaytree, return its data pointer */
  169. void * splay_find(void * key, splaytree_t * splaytree) {
  170.   splaynode_t * splaynode;
  171.   int match_type;
  172.   if (key == NULL)
  173.   return NULL;
  174.   
  175.   if (splaytree == NULL)
  176.   return NULL;
  177.   
  178.   splaynode = splaytree->root;
  179.   
  180.   /* Bring the targeted splay node to the top of the splaytree */
  181.   splaynode = splay(key, splaynode, &match_type, splaytree->compare);
  182.   splaytree->root = splaynode;
  183.   
  184.   
  185.   /* We only want perfect matches, so return null when match isn't perfect */
  186.   if (match_type == CLOSEST_MATCH) 
  187.     return NULL;
  188.   /* This shouldn't happen because of the match type check, but whatever */
  189.   if (splaytree->root == NULL)
  190.   return NULL;
  191.   
  192.   /* Node is a regular type, return its data pointer */
  193.   if (splaytree->root->type == REGULAR_NODE_TYPE) /* regular node */
  194.    return splaytree->root->data;
  195.   
  196.   /* If the node is a symlink, pursue one link */
  197.   if (splaytree->root->type == SYMBOLIC_NODE_TYPE) /* symbolic node */
  198. return ((splaynode_t*)splaytree->root->data)->data;
  199.     
  200.   
  201.   /* Unknown type */
  202.   return NULL;
  203. }
  204. /* Gets the splaynode that the given key points to */
  205. splaynode_t * get_splaynode_of(void * key, splaytree_t * splaytree) {
  206.   splaynode_t * splaynode;
  207.   int match_type;
  208.   
  209.   /* Null argument checks */
  210.   if (splaytree == NULL)
  211.   return NULL;
  212.   
  213.   if (key == NULL)
  214.   return NULL;
  215.   
  216.   splaynode = splaytree->root;
  217.   /* Find the splaynode */
  218.   splaynode = splay(key, splaynode, &match_type, splaytree->compare);
  219.   splaytree->root = splaynode;
  220.  
  221.   /* Only perfect matches are valid */
  222.   if (match_type == CLOSEST_MATCH)
  223.     return NULL;
  224.   /* Return the perfect match splay node */
  225.   return splaynode;
  226. }
  227. /* Finds the desired node, and changes the tree such that it is the root */
  228. splaynode_t * splay (void * key, splaynode_t * t, int * match_type, int (*compare)()) {
  229.   
  230. /* Simple top down splay, not requiring key to be in the tree t. 
  231.    What it does is described above. */
  232.  
  233.     splaynode_t N, *l, *r, *y;
  234.     *match_type = CLOSEST_MATCH;
  235.   
  236. if (t == NULL) return t;
  237.     N.left = N.right = NULL;
  238.     l = r = &N;
  239.   
  240.     for (;;) {
  241. if (compare(key, t->key) < 0) {
  242.     if (t->left == NULL) break;
  243.     if (compare(key, t->left->key) < 0) {
  244. y = t->left;                           /* rotate right */
  245. t->left = y->right;
  246. y->right = t;
  247. t = y;
  248. if (t->left == NULL) break;
  249.     }
  250.     r->left = t;                               /* link right */
  251.     r = t;
  252.     t = t->left;
  253. } else if (compare(key, t->key) > 0) {
  254.     if (t->right == NULL) break;
  255.     if (compare(key, t->right->key) > 0) {
  256. y = t->right;                          /* rotate left */
  257. t->right = y->left;
  258. y->left = t;
  259. t = y;
  260. if (t->right == NULL) break;
  261.     }
  262.     l->right = t;                              /* link left */
  263.     l = t;
  264.     t = t->right;
  265. } else {
  266.   *match_type = PERFECT_MATCH;
  267.   break;
  268. }
  269.     }
  270.     l->right = t->left;                                /* assemble */
  271.     r->left = t->right;
  272.     t->left = N.right;
  273.     t->right = N.left;
  274.     
  275.     return t;
  276.     //return NULL;
  277. }
  278. /* Deletes a splay node from a splay tree. If the node doesn't exist
  279.    then nothing happens */
  280. int splay_delete(void * key, splaytree_t * splaytree) {
  281.   
  282.   splaynode_t * splaynode;
  283.   /* Use helper function to delete the node and return the resulting tree */
  284.   if ((splaynode = splay_delete_helper(key, splaytree->root, splaytree->compare, splaytree->free_key)) == NULL)
  285.   return FAILURE;
  286.   
  287.   /* Set new splaytree root equal to the returned splaynode after deletion */
  288.   splaytree->root = splaynode;
  289.   
  290.   /* Finished, no errors */
  291.   return SUCCESS;
  292. }
  293. /* Deletes a splay node */
  294. splaynode_t * splay_delete_helper(void * key, splaynode_t * splaynode, int (*compare)(), void (*free_key)()) {
  295.     splaynode_t * new_root;
  296.     int match_type;
  297. /* Argument check */
  298.     if (splaynode == NULL) 
  299. return NULL;
  300.     splaynode = splay(key, splaynode, &match_type, compare);
  301. /* If entry wasn't found, quit here */
  302. if (match_type == CLOSEST_MATCH) 
  303. return NULL;
  304. /* If the targeted node's left pointer is null, then set the new root
  305.    equal to the splaynode's right child */
  306. if (splaynode->left == NULL) {
  307.     new_root = splaynode->right;
  308. /* Otherwise, do something I don't currently understand */
  309. else {
  310.     new_root = splay(key, splaynode->left, &match_type, compare);
  311.     new_root->right = splaynode->right;
  312. }
  313. /* Set splay nodes children pointers to null */
  314. splaynode->left = splaynode->right = NULL;
  315. /* Free the splaynode (and only this node since its children are now empty */
  316. free_splaynode(splaynode, free_key);
  317. /* Return the resulting tree */
  318. return new_root;
  319. }
  320. /* Create a new splay node type */
  321. splaynode_t * new_splaynode(int type, void * key, void * data) {
  322. splaynode_t * splaynode;
  323. /* Argument checks */
  324. if (data == NULL)
  325. return NULL;
  326. if (key == NULL)
  327. return NULL;
  328. /* Creates the new splay node struct */
  329. if ((splaynode = (splaynode_t*)malloc(sizeof(splaynode_t))) == NULL)
  330. return NULL;
  331. splaynode->data = data;
  332. splaynode->type = type;
  333. splaynode->key = key;
  334. /* Return the new splay node */
  335. return splaynode;
  336. }
  337. /* Inserts a link into the splay tree */
  338. int splay_insert_link(const void * alias_key, void * orig_key, splaytree_t * splaytree) {
  339.    splaynode_t * splaynode, * data_node;
  340.    void * key_clone;
  341.    /* Null arguments */
  342.    if (splaytree == NULL)
  343. return FAILURE;
  344.    
  345.    if (alias_key == NULL)
  346.     return FAILURE;
  347.    if (orig_key == NULL)
  348.     return FAILURE;
  349.    
  350.    /* Find the splaynode corresponding to the original key */
  351.    if ((data_node = get_splaynode_of(orig_key, splaytree)) == NULL)
  352.    return FAILURE;
  353.    
  354.    /* Create a new splay node of symbolic link type */
  355.    if ((splaynode = new_splaynode(SYMBOLIC_NODE_TYPE, (key_clone = splaytree->copy_key(alias_key)), data_node)) == NULL) {
  356. splaytree->free_key(key_clone);
  357. return OUTOFMEM_ERROR;
  358.    }
  359.    /* Insert the splaynode into the given splaytree */
  360.    if ((splay_insert_node(splaynode, splaytree)) < 0) {
  361.      splaynode->left=splaynode->right = NULL;
  362.      free_splaynode(splaynode, splaytree->free_key);
  363.      return FAILURE;
  364.    }
  365.    /* Done, return success */
  366.    return SUCCESS;
  367. }
  368. /* Inserts 'data' into the 'splaytree' paired with the passed 'key' */
  369. int splay_insert(void * data, void * key, splaytree_t * splaytree) {
  370. splaynode_t * splaynode;
  371. void * key_clone;
  372. /* Null argument checks */
  373. if (splaytree == NULL) {
  374.     return FAILURE;
  375. }
  376. if (key == NULL)
  377. return FAILURE;
  378. /* Clone the key argument */
  379. key_clone = splaytree->copy_key(key);
  380. /* Create a new splaynode (of regular type) */
  381. if ((splaynode = new_splaynode(REGULAR_NODE_TYPE, key_clone, data)) == NULL) {
  382. splaytree->free_key(key_clone);
  383. return OUTOFMEM_ERROR;
  384. }
  385.        
  386. /* Inserts the splaynode into the splaytree */
  387. if (splay_insert_node(splaynode, splaytree) < 0) {
  388.   splaynode->left=splaynode->right=NULL;
  389.   free_splaynode(splaynode, splaytree->free_key);
  390.   return FAILURE;
  391. }
  392.      
  393. return SUCCESS;
  394. }
  395. /* Helper function to insert splaynodes into the splaytree */
  396. int splay_insert_node(splaynode_t * splaynode, splaytree_t * splaytree) {
  397.   int match_type;
  398.   int cmpval;
  399.   void * key;
  400.   splaynode_t * t;
  401.   /* Null argument checks */
  402.   if (splaytree == NULL)
  403.     return FAILURE;
  404.   if (splaynode == NULL)
  405. return FAILURE;
  406.   
  407.   key = splaynode->key;
  408.   
  409.   t = splaytree->root; 
  410.   /* Root is null, insert splaynode here */
  411.   if (t == NULL) {
  412. splaynode->left = splaynode->right = NULL;
  413. splaytree->root = splaynode;
  414. return SUCCESS;
  415.   }
  416.   
  417.   t = splay(key, t, &match_type, splaytree->compare);
  418.   
  419.   if ((cmpval = splaytree->compare(key,t->key)) < 0) {
  420. splaynode->left = t->left;
  421. splaynode->right = t;
  422. t->left = NULL;
  423. splaytree->root = splaynode;
  424. return SUCCESS;
  425.   } 
  426.   else if (cmpval > 0) {
  427. splaynode->right = t->right;
  428. splaynode->left = t;
  429. t->right = NULL; 
  430. splaytree->root = splaynode;
  431. return SUCCESS;
  432.    } 
  433.    
  434.    /* Item already exists in tree, don't reinsert */
  435.   else {
  436.     
  437.     return FAILURE;
  438.   }
  439. }
  440. /* Returns the 'maximum' key that is less than the given key in the splaytree */
  441. void * splay_find_below_max(void * key, splaytree_t * splaytree) {
  442. void * closest_key;
  443. if (splaytree == NULL)
  444. return NULL;
  445. if (splaytree->root == NULL)
  446. return NULL;
  447. if (key == NULL)
  448. return NULL;
  449. closest_key = NULL;
  450. splay_find_below_max_helper(key, &closest_key, splaytree->root, splaytree->compare);
  451. if (closest_key == NULL) return NULL;
  452. return splay_find(closest_key, splaytree);
  453. }
  454. /* Returns the 'minimum' key that is greater than the given key in the splaytree */
  455. void * splay_find_above_min(void * key, splaytree_t * splaytree) {
  456. void * closest_key;
  457. if (splaytree == NULL)
  458. return NULL;
  459. if (splaytree->root == NULL)
  460. return NULL;
  461. if (key == NULL)
  462. return NULL;
  463. closest_key = NULL;
  464. splay_find_above_min_helper(key, &closest_key, splaytree->root, splaytree->compare);
  465. if (closest_key == NULL) { 
  466. return NULL;
  467. }
  468. return splay_find(closest_key, splaytree);
  469. }
  470. /* Helper function */
  471. void splay_find_below_max_helper(void * min_key, void ** closest_key, splaynode_t * root, int (*compare)()) {
  472. /* Empty root, return*/
  473. if (root == NULL)
  474. return;
  475. /* The root key is less than the previously found closest key.
  476.    Also try to make the key non null if the value is less than the max key */
  477. if ((*closest_key == NULL) || (compare(root->key, *closest_key) < 0)) {
  478. /*  The root key is less than the given max key, so this is the
  479. smallest change from the given max key */
  480. if (compare(root->key, min_key) > 0) {
  481. *closest_key = root->key;
  482. /* Look right again in case even a greater key exists that is 
  483.    still less than the given max key */
  484. splay_find_below_max_helper(min_key, closest_key, root->left, compare);
  485. }
  486. /* The root key is greater than the given max key, and greater than 
  487.    the closest key, so search left */
  488. else {
  489. splay_find_below_max_helper(min_key, closest_key, root->right, compare);
  490. }
  491. }
  492. /* The root key is less than the found closest key, search right */
  493. else {
  494. splay_find_below_max_helper(min_key, closest_key, root->left, compare);
  495. }
  496. }
  497. /* Helper function */
  498. void splay_find_above_min_helper(void * max_key, void ** closest_key, splaynode_t * root, int (*compare)()) {
  499. /* Empty root, stop */
  500. if (root == NULL)
  501. return;
  502. /* The root key is greater than the previously found closest key.
  503.    Also try to make the key non null if the value is less than the min key */
  504. if ((*closest_key == NULL) || (compare(root->key, *closest_key) > 0)) {
  505. /*  The root key is greater than the given min key, so this is the
  506. smallest change from the given min key */
  507. if (compare(root->key, max_key) < 0) {
  508. *closest_key = root->key;
  509.    /* Look left again in case even a smaller key exists that is 
  510.   still greater than the given min key */
  511. splay_find_above_min_helper(max_key, closest_key, root->right, compare);
  512. }
  513. /* The root key is less than the given min key, and less than 
  514.    the closest key, so search right */
  515. else {
  516. splay_find_above_min_helper(max_key, closest_key, root->left, compare);
  517. }
  518. }
  519. /* The root key is greater than the found closest key, search left */
  520. else {
  521. splay_find_above_min_helper(max_key, closest_key, root->right, compare);
  522. }
  523. }
  524. /* Find the minimum entry of the splay tree */
  525. void * splay_find_min(splaytree_t * t) {
  526. splaynode_t * splaynode;
  527. if (t == NULL)
  528. return NULL;
  529. if (t->root == NULL)
  530. return NULL;
  531. splaynode = t->root;
  532. while (splaynode->left != NULL)
  533. splaynode= splaynode->left;
  534. return splaynode->data;
  535. }
  536. /* Find the maximum entry of the splay tree */
  537. void * splay_find_max(splaytree_t * t) {
  538. splaynode_t * splaynode;
  539. if (t == NULL)
  540. return NULL;
  541. if (t->root == NULL)
  542. return NULL;
  543. splaynode = t->root;
  544.  
  545. while (splaynode->right != NULL) {
  546.   printf("data:%dn", *(int*)splaynode->key);
  547. splaynode = splaynode->right;
  548. }
  549. return splaynode->data;
  550. }
  551. int splay_size(splaytree_t * t) {
  552. if (t == NULL)
  553.   return 0;
  554. if (t->root == NULL)
  555.   return 0;
  556. return splay_rec_size(t->root);
  557.  
  558. }
  559. int splay_rec_size(splaynode_t * splaynode) {
  560.   if (!splaynode)
  561.     return 0;
  562.   return 1 + splay_rec_size(splaynode->left) + splay_rec_size(splaynode->right);
  563. }