X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fdictionary.h;h=9d277078a599e0064cba98cf69a29b07b8e88d4a;hb=2117c711ae07700adb57ea5b5ca61e4c32d7e3d2;hp=64fbb93e6862d33a288ff7c63c13d156807cf541;hpb=197e01b6dcd118b70ed3621b62b2ff3fa929d50f;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/dictionary.h b/gdb/dictionary.h index 64fbb93e68..9d277078a5 100644 --- a/gdb/dictionary.h +++ b/gdb/dictionary.h @@ -1,6 +1,6 @@ /* Routines for name->symbol lookups in GDB. - Copyright (C) 2003 Free Software Foundation, Inc. + Copyright (C) 2003-2014 Free Software Foundation, Inc. Contributed by David Carlton and by Kealia, Inc. @@ -9,22 +9,22 @@ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or (at - your option) any later version. + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. - This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. */ + along with this program. If not, see . */ #ifndef DICTIONARY_H #define DICTIONARY_H +#include "symfile.h" + /* An opaque type for dictionaries; only dictionary.c should know about its innards. */ @@ -85,6 +85,11 @@ extern void dict_free (struct dictionary *dict); extern void dict_add_symbol (struct dictionary *dict, struct symbol *sym); +/* Utility to add a list of symbols to a dictionary. */ + +extern void dict_add_pending (struct dictionary *dict, + const struct pending *symbol_list); + /* Is the dictionary empty? */ extern int dict_empty (struct dictionary *dict); @@ -118,7 +123,7 @@ extern struct symbol *dict_iterator_first (const struct dictionary *dict, extern struct symbol *dict_iterator_next (struct dict_iterator *iterator); /* Initialize ITERATOR to point at the first symbol in DICT whose - SYMBOL_BEST_NAME is NAME (as tested using strcmp_iw), and return + SYMBOL_SEARCH_NAME is NAME (as tested using strcmp_iw), and return that first symbol, or NULL if there are no such symbols. */ extern struct symbol *dict_iter_name_first (const struct dictionary *dict, @@ -126,7 +131,7 @@ extern struct symbol *dict_iter_name_first (const struct dictionary *dict, struct dict_iterator *iterator); /* Advance ITERATOR to point at the next symbol in DICT whose - SYMBOL_BEST_NAME is NAME (as tested using strcmp_iw), or NULL if + SYMBOL_SEARCH_NAME is NAME (as tested using strcmp_iw), or NULL if there are no more such symbols. Don't call this if you've previously received NULL from dict_iterator_first or dict_iterator_next on this iteration. And don't call it unless @@ -136,6 +141,29 @@ extern struct symbol *dict_iter_name_first (const struct dictionary *dict, extern struct symbol *dict_iter_name_next (const char *name, struct dict_iterator *iterator); +/* Initialize ITERATOR to point at the first symbol in DICT whose + SYMBOL_SEARCH_NAME is NAME, as tested using COMPARE (which must use + the same conventions as strcmp_iw and be compatible with any + dictionary hashing function), and return that first symbol, or NULL + if there are no such symbols. */ + +extern struct symbol *dict_iter_match_first (const struct dictionary *dict, + const char *name, + symbol_compare_ftype *compare, + struct dict_iterator *iterator); + +/* Advance ITERATOR to point at the next symbol in DICT whose + SYMBOL_SEARCH_NAME is NAME, as tested using COMPARE (see + dict_iter_match_first), or NULL if there are no more such symbols. + Don't call this if you've previously received NULL from + dict_iterator_match_first or dict_iterator_match_next on this + iteration. And don't call it unless ITERATOR was created by a + previous call to dict_iter_match_first with the same NAME and COMPARE. */ + +extern struct symbol *dict_iter_match_next (const char *name, + symbol_compare_ftype *compare, + struct dict_iterator *iterator); + /* Return some notion of the size of the dictionary: the number of symbols if we have that, the number of hash buckets otherwise. */