mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-06-26 22:07:58 +08:00
Add comments to dwarf2/abbrev-cache.h
This patch started when I noticed that the unordered_set include wasn't needed in abbrev-cache.h. (That was probably leftover from some earlier implementation of the class.) Then, I noticed that the class itself was under-commented. This patch fixes both issues.
This commit is contained in:
@ -21,15 +21,18 @@
|
|||||||
#define GDB_DWARF2_ABBREV_CACHE_H
|
#define GDB_DWARF2_ABBREV_CACHE_H
|
||||||
|
|
||||||
#include "dwarf2/abbrev.h"
|
#include "dwarf2/abbrev.h"
|
||||||
#include <unordered_set>
|
|
||||||
#include "gdbtypes.h"
|
#include "gdbtypes.h"
|
||||||
|
|
||||||
|
/* An abbrev cache holds abbrev tables for easier reuse. */
|
||||||
class abbrev_cache
|
class abbrev_cache
|
||||||
{
|
{
|
||||||
public:
|
public:
|
||||||
abbrev_cache ();
|
abbrev_cache ();
|
||||||
DISABLE_COPY_AND_ASSIGN (abbrev_cache);
|
DISABLE_COPY_AND_ASSIGN (abbrev_cache);
|
||||||
|
|
||||||
|
/* Find an abbrev table coming from the abbrev section SECTION at
|
||||||
|
offset OFFSET. Return the table, or nullptr if it has not yet
|
||||||
|
been registered. */
|
||||||
abbrev_table *find (struct dwarf2_section_info *section, sect_offset offset)
|
abbrev_table *find (struct dwarf2_section_info *section, sect_offset offset)
|
||||||
{
|
{
|
||||||
search_key key = { section, offset };
|
search_key key = { section, offset };
|
||||||
@ -38,6 +41,11 @@ public:
|
|||||||
to_underlying (offset));
|
to_underlying (offset));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/* Add TABLE to this cache. Ownership of TABLE is transferred to
|
||||||
|
the cache. Note that a table at a given section+offset may only
|
||||||
|
be registered once -- a violation of this will cause an assert.
|
||||||
|
To avoid this, call the 'find' method first, to see if the table
|
||||||
|
has already been read. */
|
||||||
void add (abbrev_table_up table);
|
void add (abbrev_table_up table);
|
||||||
|
|
||||||
private:
|
private:
|
||||||
|
Reference in New Issue
Block a user