/***** includes *****/ #include "lfds710_btree_addonly_unbalanced_internal.h" /***** private prototypes *****/ static void lfds710_btree_au_internal_validate( struct lfds710_btree_au_state *abs, struct lfds710_misc_validation_info *vi, enum lfds710_misc_validity *lfds710_btree_au_validity ); /****************************************************************************/ void lfds710_btree_au_query( struct lfds710_btree_au_state *baus, enum lfds710_btree_au_query query_type, void *query_input, void *query_output ) { LFDS710_PAL_ASSERT( baus != NULL ); // TRD : query_type can be any value in its range LFDS710_MISC_BARRIER_LOAD; switch( query_type ) { case LFDS710_BTREE_AU_QUERY_GET_POTENTIALLY_INACCURATE_COUNT: { struct lfds710_btree_au_element *baue = NULL; LFDS710_PAL_ASSERT( query_input == NULL ); LFDS710_PAL_ASSERT( query_output != NULL ); *(lfds710_pal_uint_t *) query_output = 0; while( lfds710_btree_au_get_by_absolute_position_and_then_by_relative_position(baus, &baue, LFDS710_BTREE_AU_ABSOLUTE_POSITION_SMALLEST_IN_TREE, LFDS710_BTREE_AU_RELATIVE_POSITION_NEXT_LARGER_ELEMENT_IN_ENTIRE_TREE) ) ( *(lfds710_pal_uint_t *) query_output )++; } break; case LFDS710_BTREE_AU_QUERY_SINGLETHREADED_VALIDATE: // TRD : query_input can be NULL LFDS710_PAL_ASSERT( query_output != NULL ); lfds710_btree_au_internal_validate( baus, (struct lfds710_misc_validation_info *) query_input, (enum lfds710_misc_validity *) query_output ); break; } return; } /****************************************************************************/ static void lfds710_btree_au_internal_validate( struct lfds710_btree_au_state *baus, struct lfds710_misc_validation_info *vi, enum lfds710_misc_validity *lfds710_btree_au_validity ) { lfds710_pal_uint_t number_elements_from_query_tree = 0, number_elements_from_walk = 0; struct lfds710_btree_au_element *baue = NULL, *baue_prev = NULL; LFDS710_PAL_ASSERT( baus!= NULL ); // TRD : vi can be NULL LFDS710_PAL_ASSERT( lfds710_btree_au_validity != NULL ); *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_VALID; /* TRD : validation is performed by; performing an in-order walk we should see every element is larger than the preceeding element we count elements as we go along (visited elements, that is) and check our tally equals the expected count */ LFDS710_MISC_BARRIER_LOAD; while( lfds710_btree_au_get_by_absolute_position_and_then_by_relative_position(baus, &baue, LFDS710_BTREE_AU_ABSOLUTE_POSITION_SMALLEST_IN_TREE, LFDS710_BTREE_AU_RELATIVE_POSITION_NEXT_LARGER_ELEMENT_IN_ENTIRE_TREE) ) { // TRD : baue_prev should always be smaller than or equal to baue if( baue_prev != NULL ) if( baus->key_compare_function(baue_prev->key, baue->key) > 0 ) { *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_INVALID_ORDER; return; } baue_prev = baue; number_elements_from_walk++; } if( *lfds710_btree_au_validity == LFDS710_MISC_VALIDITY_VALID ) { lfds710_btree_au_query( (struct lfds710_btree_au_state *) baus, LFDS710_BTREE_AU_QUERY_GET_POTENTIALLY_INACCURATE_COUNT, NULL, &number_elements_from_query_tree ); if( number_elements_from_walk > number_elements_from_query_tree ) *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_INVALID_ADDITIONAL_ELEMENTS; if( number_elements_from_walk < number_elements_from_query_tree ) *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_INVALID_MISSING_ELEMENTS; } /* TRD : now check for expected number of elements vi can be NULL, in which case we do not check we know we don't have a loop from our earlier check */ if( *lfds710_btree_au_validity == LFDS710_MISC_VALIDITY_VALID and vi != NULL ) { lfds710_btree_au_query( (struct lfds710_btree_au_state *) baus, LFDS710_BTREE_AU_QUERY_GET_POTENTIALLY_INACCURATE_COUNT, NULL, &number_elements_from_query_tree ); if( number_elements_from_query_tree < vi->min_elements ) *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_INVALID_MISSING_ELEMENTS; if( number_elements_from_query_tree > vi->max_elements ) *lfds710_btree_au_validity = LFDS710_MISC_VALIDITY_INVALID_ADDITIONAL_ELEMENTS; } return; }