1.\" 2.\" This file and its contents are supplied under the terms of the 3.\" Common Development and Distribution License ("CDDL"), version 1.0. 4.\" You may only use this file in accordance with the terms of version 5.\" 1.0 of the CDDL. 6.\" 7.\" A full copy of the text of the CDDL should have accompanied this 8.\" source. A copy of the CDDL is also available via the Internet at 9.\" http://www.illumos.org/license/CDDL. 10.\" 11.\" 12.\" Copyright 2015 Joyent, Inc. 13.\" 14.Dd May 07, 2015 15.Dt AVL_DESTROY 3AVL 16.Os 17.Sh NAME 18.Nm avl_destroy 19.Nd destroy an AVL tree 20.Sh SYNOPSIS 21.Lb libavl 22.In sys/avl.h 23.Ft void 24.Fo avl_destroy 25.Fa "avl_tree_t *tree" 26.Fc 27.Sh DESCRIPTION 28The 29.Fn avl_destroy 30function is used to destroy the AVL tree that is rooted at 31.Fa tree . 32At the time that 33.Fn avl_destroy 34is called, 35.Fa tree 36must be empty. It is a programmer error to call 37.Fn avl_destroy 38otherwise. To efficiently remove all entries in the tree, see 39.Xr avl_destroy_nodes 3AVL . 40.Pp 41After a call to 42.Fn avl_destroy , 43.Fa tree 44should not be used with any other library functions until a subsequent 45call to 46.Xr avl_create 3AVL . 47.Sh EXAMPLES 48See the 49.Sy EXAMPLES 50section in 51.Xr libavl 3LIB . 52.Sh INTERFACE STABILITY 53.Sy Committed 54.Sh MT-Level 55See 56.Sx Locking 57in 58.Xr libavl 3LIB . 59.Sh SEE ALSO 60.Xr libavl 3LIB , 61.Xr avl_create 3AVL , 62.Xr avl_destroy_nodes 3AVL 63