How do you read C declarations?

by

This article explains a relatively simple 7 rules which will let you read any C declaration, if you find yourself wanting or needing to do so manually: http://www.ericgiguere.com/articles/reading-c-declarations.html

  1. Find the identifier. This is your starting point. On a piece of paper, write “declare identifier as”.
  2. Look to the right. If there is nothing there, or there is a right parenthesis “)”, goto step 4.

  3. You are now positioned either on an array (left bracket) or function (left parenthesis) descriptor. There may be a sequence of these, ending either with an unmatched right parenthesis or the end of the declarator (a semicolon or a “=” for initialization). For each such descriptor, reading from left to right:

    • if an empty array “[]”, write “array of”
    • if an array with a size, write “array size of”
    • if a function “()”, write “function returning”

    Stop at the unmatched parenthesis or the end of the declarator, whichever comes first.

  4. Return to the starting position and look to the left. If there is nothing there, or there is a left parenthesis “(“, goto step 6.
  5. You are now positioned on a pointer descriptor, “*”. There may be a sequence of these to the left, ending either with an unmatched left parenthesis “(” or the start of the declarator. Reading from right to left, for each pointer descriptor write “pointer to”. Stop at the unmatched parenthesis or the start of the declarator, whichever is first.
  6. At this point you have either a parenthesized expression or the complete declarator. If you have a parenthesized expression, consider it as your new starting point and return to step 2.
  7. Write down the type specifier. Stop.

If you’re fine with a tool, then I second the suggestion to use the program cdecl: http://gd.tuwien.ac.at/linuxcommand.org/man_pages/cdecl1.html

More Related Contents:

  1. Is there a way to use a typedef struct variable in a function…? [closed]
  2. Usage of uint_8, uint_16 and uint_32
  3. typedef struct vs struct definitions [duplicate]
  4. self referential struct definition?
  5. Understanding typedefs for function pointers in C
  6. Are typedef and #define the same in c?
  7. Why should we typedef a struct so often in C?
  8. typedef pointer const weirdness
  9. typedef fixed length array
  10. How to define a typedef struct containing pointers to itself?
  11. Opaque C structs: various ways to declare them
  12. uint8_t vs unsigned char
  13. What is ‘forward declaration’ and the difference between ‘typedef struct X’ and ‘struct X’?
  14. C typedef of pointer to structure
  15. Enforce strong type checking in C (type strictness for typedefs)
  16. C Typedef and Struct Question
  17. C : typedef struct name {…}; VS typedef struct{…} name;
  18. Why does “typdef struct { struct S *s; } S;” containing a pointer to same type compile?
  19. Is typedef’ing a pointer type considered bad practice? [duplicate]
  20. Convert objective-c typedef to its string equivalent
  21. What does a typedef with parenthesis like “typedef int (f)(void)” mean? Is it a function prototype?
  22. What is the use of typedef?
  23. C Typedef – Incomplete Type
  24. dereferencing pointer to incomplete type
  25. How to create a typedef for function pointers
  26. In C, is it good form to use typedef for a pointer?
  27. Program to find sum up-to …..nth number [closed]
  28. Segmentation fault using scanf() [closed]
  29. Obtaining peak bandwidth on Haswell in the L1 cache: only getting 62%
  30. Create statically-linked binary that uses getaddrinfo?

Leave a Comment