static functions

static functions are functions that are only visable to other functions in the same file. Consider the following code.

main.c
#include main() { Func1(); Func2(); }

funcs.c
/************************************* * * Function declarations (prototypes). * ************************************/ / Func1 is only visable to functions in this file. / static* void Func1(void); /* Func2 is visable to all functions. / void Func2(void); /************************************ * * Function definitions * ***********************************/ void Func1(void) { puts("Func1 called"); } /***********************************/ void Func2(void) { puts("Func2 called"); }

funcs.c


   /*************************************
    *
    * Function declarations (prototypes).
    *
    *************************************/

   /* Func1 is only visable to functions in this file. */   

   static void Func1(void);

   /* Func2 is visable to all functions. */

   void Func2(void); 

   /*************************************
    *
    * Function definitions
    *
    *************************************/
       
   void Func1(void)
   {
     puts("Func1 called");
   }
   
   /*************************************/
   
   void Func2(void)        
   {
     puts("Func2 called");
   }

If you attempted to compile this code with the following command,


   gcc main.c funcs.c

it will fail with an error simular to.....


   undefined reference to `Func1'

Because 'Func1' is declared as static and cannot be 'seen' by 'main.c'.

Notes:

For some reason, static has different meanings in in different contexts.

When specified on a function declaration, it makes the function local to the file.
When specified with a variable inside a function, it allows the vairable to retain its value between calls to the function. See static variables.

It seems a little strange that the same keyword has such different meanings....

static functions

Notes:

See Also:

Welcome to massmind.org!

Welcome to techref.massmind.org!