User's Guide to gperf 3.2

The GNU Perfect Hash Function Generator

Edition 3.2, 28 October 2024

Table of Contents

• GNU GENERAL PUBLIC LICENSE
• Contributors to GNU gperf Utility
• 2 Introduction
• 3 Static search structures and GNU gperf
• 4 High-Level Description of GNU gperf
  • 4.1 Input Format to gperf
    • 4.1.1 Declarations
      • 4.1.1.1 User-supplied struct
      • 4.1.1.2 Gperf Declarations
      • 4.1.1.3 C Code Inclusion
    • 4.1.2 Format for Keyword Entries
    • 4.1.3 Including Additional C Functions
    • 4.1.4 Where to place directives for GNU indent.
  • 4.2 Output Format for Generated C Code with gperf
  • 4.3 Use of NUL bytes
  • 4.4 Controlling Identifiers
  • 4.5 The Copyright of the Output
• 5 Invoking gperf
  • 5.1 Specifying the Location of the Output File
  • 5.2 Options that affect Interpretation of the Input File
  • 5.3 Options to specify the Language for the Output Code
  • 5.4 Options for fine tuning Details in the Output Code
  • 5.5 Options for changing the Algorithms employed by gperf
  • 5.6 Informative Output
• 6 Known Bugs and Limitations with gperf
• 7 Things Still Left to Do
• 8 Bibliography
• Concept Index

Copyright (C) 1989-2024 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided also that the section entitled “GNU General Public License” is included exactly as in the original, and provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that the section entitled “GNU General Public License” may be included in a translation approved by the author instead of in the original English.