MagNumDB is a database that contains about 300,000 items. These items are constants, names, values
all extracted from more than 4,000 header files (.h, .hxx, .hpp, .idl, etc.) provided by standard Windows and Visual Studio SDKs.
Some values have been extracted from the very special uuid.lib file that contains the value of thousands of guids and property keys, not present anywhere else in header files.

"C2P5"

To build this database, we have written a powerful C/C++ parser named C2P5 (for C/CPP/PreProcessor/Parser), tailored specifically for this task.
C2P5 is capable of preprocessing, parsing and partially evaluating all header files as if they were included in a one big virtual project (that of course, does not compile). It currently supports the following preprocessor and C/C++ constructs:

#define preprocessor that define constants

#define preprocessor that define expression to compute constants

C and C++ enum definitions

Special GUID constructs like DECLSPEC_UUID, DEFINE_GUIDSTRUCT or MIDL_INTERFACE

Some IDL constructs

Etc.

The parser remembers dynamic preprocessor definitions (#if, #ifdef, etc.) that are conditions for constants definitions and expression computation.
All parsed items are saved in the database, as well as the associated conditions.
There may be more than one item corresponding to a given name, if there are differences in their associated conditions.

C2P5 supports the following types of constants, regardless of the way they are defined in source files:

Type: the item's type, expressed in a specific, universal system.
Corresponding Lucene's field: valuetype, but use the value of the Storage type column for queries on items type.

Value: the item's value. For string values, it's displayed as is w/o quotes nor escaping.
Corresponding database field: value. There is also a typedvalue field that can contain Lucene's Int32, Int64, Float, Double or String typed values.

Hex Value: the item's hexadecimal value, only valid for integer types.
There is no corresponding database field.

Signed Value: the item's signed value, only valid for integer and double types.
Useful when you found a unsigned number and want to get the corresponding signed value (uint -> int for example).
There is no corresponding database field.

Source lines(s): the source lines from which the item was extracted. Comments and characters such as TAB, CR are preserved.
Corresponding database field: source.

File path: the file path from which the item was extracted, terminated by the line index.
Corresponding database field: filepath. There are also directory and filename fields.
filename is useful to query for values in a given file.

Score: Lucene's score value. Items are returned sorted by score.

Guid formats: a utility columns that proposes all possible guid formats. Only valid for guid types.
There is no corresponding database field

Storage type: the exact storage type in the database. Only used for specific queries.
Corresponding database field: valuetype.

Conditions: the list of preprocessor conditions for a given item. If a condition is surrounded with a REVERSE function, it means the reverse condition of what's surrounded was the condition.
Corresponding database field: conditions. There may be multiple conditions fields for one item.

Some important points to note:

If you search for a negative number (like error codes expressed using signed integers), you can surround the search with double quotes, for example searching for "-2147009290" is equivalent to searching for 0x80073CF6, 80073CF6 (or even 3CF6 in this specific case).
If you don't surround negative numbers with double quotes, the system will search for signed and unsigned corresponding values.

Q: I always get back 400 items at most. Why?A: The MagNumDb site currently limits the number of returned items to this value by design. This should be enough for most real search scenarios (like enums with a big list of values).

Q: Some values are empty. Why?A: The expression evaluator cannot always compute the final value, because it sometimes require contextual information (custom defines, compiler architecture, etc.) that the parser doesn't have.
You can enable the Source line(s) column to check what's the corresponding source and try to work it out by yourself. The origin file path and line number is also included.

Q: Can I get all values for a given enum?A: Sure. For example, __VSHPROPID is the name of an enum, and a query like this: parent:__VSHPROPID will get all the enum's values (66 entries).

Q: I sometimes get back items whose name starts with "__magnumdb__enum_". Why?A: C allows unnamed enums. The MagNumDb parser just gives them a name, using the defining file name and a counter.

Q: I sometimes get back the same item/name twice or more with different values. For example: TARGET_IS_NT60_OR_LATER. Why?A: This can be the case with defines. Their value may be different if they were surrounded by # directives (#if, #else, etc.) in the original source code.
You can enable the Condition(s) column to check what are the corresponding conditions for a given item.
Note: if a condition is surrounded with a funny REVERSE function token, it means the reverse condition of what's surrounded.

Database Metrics

Last update date: Tuesday, 17 October 2017

Items count: 304412

Parsed files count: 4278

Windows SDK version: 10.0.16299.0

Contact

We welcome feedback.
Seen anything missing? A bug? A wrong value? Do you have any suggestion for improvements?
Do you have an idea for a cool new feature?

Please contact us here

About MagNumDB

MagNumDB 2017 Simon Mourier V1.0.5. All rights reserved.

All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only.

All values, names, source code fragments displayed here have been extracted from files that are property of their respective owners.

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND OTHER THAN AS SPECIFICALLY SET FORTH IN THE LICENSE AGREEMENT, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.