filesystem_iterator_create filesystem_iterator_free filesystem_iterator_next_directory filesystem_iterator_next_file filesystem_iterator_next_subling_directory filesystem_tree_add_directory filesystem_tree_add_file filesystem_tree_create filesystem_tree_delete filesystem_tree_directory_path filesystem_tree_file_path filesystem_tree_find_directory filesystem_tree_find_file

filesystem_iterator_next_directory() GPAK_API filesystem_tree_node_t* filesystem_iterator_next_directory ( filesystem_tree_iterator_t *  _iterator ) Brief Description:\n Retrieves the next directory in the filesystem tree. This function returns the next directory node in the filesystem tree using a depth-first search algorithm. Parameters _iterator A pointer to the filesystem_tree_iterator_t. Returns A pointer to the next directory node or NULL if there are no more directories. Definition at line 294 of file filesystem_tree.c. { if (_iterator->stack_size_ == 0) return NULL; filesystem_iterator_state_t current_state = _iterator->stack_[_iterator->stack_size_ - 1]; if (current_state.child_index_ < current_state.node_->num_children_) { filesystem_tree_node_t* next_directory = current_state.node_->children_[current_state.child_index_]; filesystem_iterator_state_t child_state = { .node_ = next_directory, .child_index_ = 0, .file_index_ = 0 }; // Update the current state's child_index current_state.child_index_++; _iterator->stack_[_iterator->stack_size_ - 1] = current_state; // Push the child_state onto the stack _iterator_stack_push(_iterator, child_state); return next_directory; } else // If there are no more children, remove the current state from the stack _iterator_stack_pop(_iterator); // Call the function recursively to find the next directory return filesystem_iterator_next_directory(_iterator); } References filesystem_iterator_state::child_index_, filesystem_tree_node::children_, filesystem_iterator_state::node_, filesystem_tree_node::num_children_, filesystem_tree_iterator::stack_, and filesystem_tree_iterator::stack_size_. Referenced by _gpak_compressor_generate_dictionary().