Modern perfect hashing for strings
0x80.pl
0x80.pl
"The major drawback of gperf is that it generates function "exists", while we need a "lookup"."
gperf allows for returning actual values. I use it in a whole lot of ways (enough that I've written code that imports data to then generate enums, execute gperf and import generated code, etc), including for generating lookups for HTTP Verbs.
Let me know if you want to know how that's done and I can give more details.
struct SomeData_Gperf_st {
const char* strKey;
SomeData_et enumVal;
};
%compare-lengths
%compare-strncmp
%enum
%ignore-case
%includes
%readonly-tables
%struct-type
%define slot-name strKey
%define lookup-function-name SomeData_Find
%%
val 1, SOME_DATA__VAL_1
val 2, SOME_DATA__VAL_2
The important option here is the %struct-type option. Using that, it will find and parse the struct definition (above in the configuration), and use that to create the objects in the lookup table.The lookup table is defined after the two percent signs; %%. You simply use comma separated values. And then you just have to define the const char* to use for the lookup string, as defined by `%define slot-name`
So, gperf will then generate a function, SomeData_Find(), which returns a pointer to a SomeData_Gperf_st object. Or NULL if it's not found.
There are a number of other options available, but what you're seeing above are the options I use most often.
And, finally, I execute a command like this to run it with that config:
gperf SomeData.gperf.confg --output-file=SomeData_Find.c --multiple-iterations=100Just make sure to use a dot between my first and last name.
The key question here is whether your lexing code handles each keyword in a separate path or uses a single path for anything that looks like a keyword or identifier. Most handwritten lexing code does latter, but if you are generating code with something like re2c or a parsing expression grammar, you may be doing the prior.
In the one-path-per-keyword case, you just assign the right ID in the right code path - no need for a hash table or unique hash function. The downside is that this makes it more difficult to emit generic error messages like "blah is not a valid keyword" or to have context-sensitive keywords where you might fall back to interpreting a keyword as an identifier.
There is a reason summaries / tldr are at the top. They help your reader understand / digest all the details that follow.