1	#include <stdio.h>
2	#include <stdlib.h>
3	#include <stdarg.h>
4	
5	int AutoSumFunction (int NumberOfArguments, ...);
6	
7	int main(int argc, char *argv[])
8	{
9	  int Total = 0;
10	  Total = AutoSumFunction (-6, 12,54,24,75,45,23);
11	  printf("The total is %d", Total);
12	  system("PAUSE");
13	  return 0;
14	}
15	
16	int AutoSumFunction (int NumberOfArguments, ...)
17	{
18	    int Sum = 0, CurrentValue = 0;
19	    va_list ArgumentPointer;
20	    
21	    /*We need to use va_start to get the start of the
22	    argument list and store this in the argument pointer.
23	    The macro va_start does this*/
24	    va_start(ArgumentPointer, NumberOfArguments);
25	    
26	    /*Now we will create a loop that counts down the number
27	    of arguments.*/
28	    for(;NumberOfArguments;NumberOfArguments--)
29	    {
30	        /*We get the next value from the list of arguments,
31	        we need to tell va_arg what type of value we expect*/
32	        CurrentValue = va_arg(ArgumentPointer,int);
33	        Sum = Sum + CurrentValue;
34	    }
35	    
36	    /*We must call va_end otherwise the program could crash*/
37	    va_end(ArgumentPointer);
38	    
39	    /*Return the total*/
40	    return Sum;
41	}

Purpose of the program

This program

Break down of the code

Line 1 - This line starts with a '#' hash sign which indicates that it is a preprocessor directive. The #include directive instructs the preprocessor to copy the contents of the following file into this source code file at this point. The filename is surrounded with '<>' brackets this instructs the preprocessor to look in the system 'include' directory first for this file. So this line copies the contents of the file 'stdio.h' into the source code file at this point before compiling starts. The file 'stdio.h' contains the declaration of many basic input output functions that are used in C programs.

Line 2 - This line works in the same manner as line 1. The difference is that the preprocessor copies the contents of the file 'stdlib.h' in to the source code at this point before compiling starts. The file 'stdlib.h' contains the declaration of many basic functions used by C programs.

Line 3 - Is blank.

Line 7 - This line contains the start of our definition of the main function. As you can see main returns an int value. This value indicates to the operating system whether or not the program has terminated normally. The main function also takes two parameters these contain any command line options that are sent to you program when it starts. E.g. if you start notepad from the command line you would write notepad if you want to start notepad with a file to edit you would write notepad readme.txt. readme.txt would be a command line option. This is not a subject that will be considered further in the book so you may wish to find out more yourself.

Line 8 - This line contains the opening brace of the main function. There must be a closing brace to match every opening brace and vice versa. The closing brace is on line 13.

Line 12 - The function system("PAUSE") is used to pause the program until a key is pressed. The reason for this is that under windows the console would open, the text would be output to it then it would close. You would see little more than a flash on the screen as this happened. Try commenting out the line to see this happen.

Line 13 - The return statement is used at the end of functions to return an item of data. This item of data should match the return type declared at the start of the function. We are in the main function and as you can see in line 6 this should be an integer. The return statement marks the end of the function any code after this will not be executed your compiler will usually warn you of this when you compile the program. The value 0 is a value that tells the operating system that the program has terminated normally.

Line 14 - This line contains the closing brace of the main function.