K:/CMGDKv18/SDK/Source/SQL/MySQL/include/my_trie.h

浏览该文件的文档。

��/ *   C o p y r i g h t   ( C )   2 0 0 5   M y S Q L   A B 
 
       T h i s   p r o g r a m   i s   f r e e   s o f t w a r e ;   y o u   c a n   r e d i s t r i b u t e   i t   a n d / o r   m o d i f y 
 
       i t   u n d e r   t h e   t e r m s   o f   t h e   G N U   G e n e r a l   P u b l i c   L i c e n s e   a s   p u b l i s h e d   b y 
 
       t h e   F r e e   S o f t w a r e   F o u n d a t i o n ;   v e r s i o n   2   o f   t h e   L i c e n s e . 
 
       T h i s   p r o g r a m   i s   d i s t r i b u t e d   i n   t h e   h o p e   t h a t   i t   w i l l   b e   u s e f u l , 
 
       b u t   W I T H O U T   A N Y   W A R R A N T Y ;   w i t h o u t   e v e n   t h e   i m p l i e d   w a r r a n t y   o f 
 
       M E R C H A N T A B I L I T Y   o r   F I T N E S S   F O R   A   P A R T I C U L A R   P U R P O S E .     S e e   t h e 
 
       G N U   G e n e r a l   P u b l i c   L i c e n s e   f o r   m o r e   d e t a i l s . 
 
       Y o u   s h o u l d   h a v e   r e c e i v e d   a   c o p y   o f   t h e   G N U   G e n e r a l   P u b l i c   L i c e n s e 
 
       a l o n g   w i t h   t h i s   p r o g r a m ;   i f   n o t ,   w r i t e   t o   t h e   F r e e   S o f t w a r e 
 
       F o u n d a t i o n ,   I n c . ,   5 9   T e m p l e   P l a c e ,   S u i t e   3 3 0 ,   B o s t o n ,   M A     0 2 1 1 1 - 1 3 0 7     U S A   * / 
 
 # i f n d e f   _ t r i e _ h 
 
 # d e f i n e   _ t r i e _ h 
 
 # i f d e f     _ _ c p l u s p l u s 
 
 e x t e r n   " C "   { 
 
 # e n d i f 
 
 t y p e d e f   s t r u c t   s t _ t r i e _ n o d e 
 
 { 
 
     u i n t 1 6   l e a f ;                                 / *   D e p t h   f r o m   r o o t   n o d e   i f   m a t c h ,   0   e l s e   * / 
 
     u c h a r   c ;                                         / *   L a b e l   o n   t h i s   e d g e   * / 
 
     s t r u c t   s t _ t r i e _ n o d e   * n e x t ;     / *   N e x t   l a b e l   * / 
 
     s t r u c t   s t _ t r i e _ n o d e   * l i n k s ;   / *   A r r a y   o f   e d g e s   l e a v i n g   t h i s   n o d e   * / 
 
     s t r u c t   s t _ t r i e _ n o d e   * f a i l ;     / *   A C   f a i l u r e   f u n c t i o n   * / 
 
 }   T R I E _ N O D E ; 
 
 t y p e d e f   s t r u c t   s t _ t r i e 
 
 { 
 
     T R I E _ N O D E   r o o t ; 
 
     M E M _ R O O T   m e m _ r o o t ; 
 
     C H A R S E T _ I N F O   * c h a r s e t ; 
 
     u i n t 3 2   n n o d e s ; 
 
     u i n t 3 2   n w o r d s ; 
 
 }   T R I E ; 
 
 t y p e d e f   s t r u c t   s t _ a c _ t r i e _ s t a t e 
 
 { 
 
     T R I E   * t r i e ; 
 
     T R I E _ N O D E   * n o d e ; 
 
 }   A C _ T R I E _ S T A T E ; 
 
 e x t e r n   T R I E   * t r i e _ i n i t   ( T R I E   * t r i e ,   C H A R S E T _ I N F O   * c h a r s e t ) ; 
 
 e x t e r n   v o i d   t r i e _ f r e e   ( T R I E   * t r i e ) ; 
 
 e x t e r n   m y _ b o o l   t r i e _ i n s e r t   ( T R I E   * t r i e ,   c o n s t   u c h a r   * k e y ,   u i n t   k e y l e n ) ; 
 
 e x t e r n   m y _ b o o l   a c _ t r i e _ p r e p a r e   ( T R I E   * t r i e ) ; 
 
 e x t e r n   v o i d   a c _ t r i e _ i n i t   ( T R I E   * t r i e ,   A C _ T R I E _ S T A T E   * s t a t e ) ; 
 
 
 
 / *   ` t r i e _ g o t o '   i s   i n t e r n a l   f u n c t i o n   a n d   s h o u l d n ' t   b e   u s e d .   * / 
 
 s t a t i c   i n l i n e   T R I E _ N O D E   * t r i e _ g o t o   ( T R I E _ N O D E   * r o o t ,   T R I E _ N O D E   * n o d e ,   u c h a r   c ) 
 
 { 
 
     T R I E _ N O D E   * n e x t ; 
 
     D B U G _ E N T E R ( " t r i e _ g o t o " ) ; 
 
     f o r   ( n e x t =   n o d e - > l i n k s ;   n e x t ;   n e x t =   n e x t - > n e x t ) 
 
         i f   ( n e x t - > c   = =   c ) 
 
             D B U G _ R E T U R N ( n e x t ) ; 
 
     i f   ( r o o t   = =   n o d e ) 
 
         D B U G _ R E T U R N ( r o o t ) ; 
 
     D B U G _ R E T U R N ( N U L L ) ; 
 
 } 
 
 
 
 / * 
 
     S Y N O P S I S 
 
         i n t   a c _ t r i e _ n e x t   ( A C _ T R I E _ S T A T E   * s t a t e ,   u c h a r   * c ) ; 
 
         s t a t e   -   v a l i d   p o i n t e r   t o   ` A C _ T R I E _ S T A T E ' 
 
         c   -   c h a r a c t e r   t o   l o o k u p 
 
     D E S C R I P T I O N 
 
         I m p l e m e n t a t i o n   o f   s e a r c h   u s i n g   A h o - C o r a s i c k   a u t o m a t o n . 
 
         P e r f o r m s   c h a r - b y - c h a r   s e a r c h . 
 
     R E T U R N   V A L U E 
 
         ` a c _ t r i e _ n e x t '   r e t u r n s   l e n g t h   o f   m a t c h e d   w o r d   o r   0 . 
 
 * / 
 
 s t a t i c   i n l i n e   i n t   a c _ t r i e _ n e x t   ( A C _ T R I E _ S T A T E   * s t a t e ,   u c h a r   * c ) 
 
 { 
 
     T R I E _ N O D E   * r o o t ,   * n o d e ; 
 
     D B U G _ E N T E R ( " a c _ t r i e _ n e x t " ) ; 
 
     D B U G _ A S S E R T ( s t a t e   & &   c ) ; 
 
     r o o t =   & s t a t e - > t r i e - > r o o t ; 
 
     n o d e =   s t a t e - > n o d e ; 
 
     w h i l e   ( !   ( s t a t e - > n o d e =   t r i e _ g o t o ( r o o t ,   n o d e ,   * c ) ) ) 
 
         n o d e =   n o d e - > f a i l ; 
 
     D B U G _ R E T U R N ( s t a t e - > n o d e - > l e a f ) ; 
 
 } 
 
 
 
 / * 
 
     S Y N O P S I S 
 
         m y _ b o o l   t r i e _ s e a r c h   ( T R I E   * t r i e ,   c o n s t   u c h a r   * k e y ,   u i n t   k e y l e n ) ; 
 
         t r i e   -   v a l i d   p o i n t e r   t o   ` T R I E ' 
 
         k e y   -   v a l i d   p o i n t e r   t o   k e y   t o   i n s e r t 
 
         k e y l e n   -   n o n - 0   k e y   l e n g t h 
 
     D E S C R I P T I O N 
 
         P e r f o r m s   k e y   l o o k u p   i n   t r i e . 
 
     R E T U R N   V A L U E 
 
         ` t r i e _ s e a r c h '   r e t u r n s   ` t r u e '   i f   k e y   i s   i n   ` t r i e ' .   O t h e r w i s e , 
 
         ` f a l s e '   i s   r e t u r n e d . 
 
     N O T E S 
 
         C o n s e c u t i v e   s e a r c h   h e r e   i s   " b e s t   b y   t e s t " .   a r r a y s   a r e   v e r y   s h o r t ,   s o 
 
         b i n a r y   s e a r c h   o r   h a s h i n g   w o u l d   a d d   t o o   m u c h   c o m p l e x i t y   t h a t   w o u l d 
 
         o v e r w e i g h t   s p e e d   g a i n .   E s p e c i a l l y   b e c a u s e   c o m p i l e r   c a n   o p t i m i z e   s i m p l e 
 
         c o n s e c u t i v e   l o o p   b e t t e r   ( t e s t e d ) 
 
 * / 
 
 s t a t i c   i n l i n e   m y _ b o o l   t r i e _ s e a r c h   ( T R I E   * t r i e ,   c o n s t   u c h a r   * k e y ,   u i n t   k e y l e n ) 
 
 { 
 
     T R I E _ N O D E   * n o d e ; 
 
     u i n t   k ; 
 
     D B U G _ E N T E R ( " t r i e _ s e a r c h " ) ; 
 
     D B U G _ A S S E R T ( t r i e   & &   k e y   & &   k e y l e n ) ; 
 
     n o d e =   & t r i e - > r o o t ; 
 
     f o r   ( k =   0 ;   k   <   k e y l e n ;   k + + ) 
 
     { 
 
         u c h a r   p ; 
 
         i f   ( !   ( n o d e =   n o d e - > l i n k s ) ) 
 
             D B U G _ R E T U R N ( F A L S E ) ; 
 
         p =   k e y [ k ] ; 
 
         w h i l e   ( p   ! =   n o d e - > c ) 
 
             i f   ( !   ( n o d e =   n o d e - > n e x t ) ) 
 
                 D B U G _ R E T U R N ( F A L S E ) ; 
 
     } 
 
     D B U G _ R E T U R N ( n o d e - > l e a f   >   0 ) ; 
 
 } 
 
 # i f d e f     _ _ c p l u s p l u s 
 
 } 
 
 # e n d i f 
 
 # e n d i f