These examples are meant to complement the lecture.

Three examples

Bonus example: strings.c: how C strings work. We will not get to explore this example - but it is well worth playing with it on your own.

Key concepts

names0.c: (read a list of student names into an array and print them back out)

names0.c

preamble

  • bool data type and stdbool.h

main

  • the notion of char* representing a string, and that strings are arrays of characters
  • use of const for values that will never change.
  • declaration of names as two-dimensional array; think of it as a one-dimensional array of strings.
  • for loop with three parts:
    • 1: n=0 initializer
    • 2: two reasons to end (names is full, or file reaches EOF)
    • 3: empty
  • printf loop does not include \n because each name includes a newline character, per the contract with readline.

readline

  • we could use gets(s) to read a line from stdin, but it can easily overwrite the space allocated to string s
  • we could use fgets(s, len, stdin), which will not overwrite a string s of size len, but may not read a whole line from the input.
  • let’s write our own readline function instead.
  • detailed comment describing the contract between caller and the function.
  • while loop that runs until EOF or buffer is full. (why pos < len-1 instead of pos < len?)
  • use of pos++ notation to step through array.
  • need to null-terminate the string with \0
  • return from inside the loop.
  • need to strip excess characters from an over-length line, until we reach EOF or newline.

names1.c

names1.c: (pulls out readline() to readline.c and readline.h)

names1.c

  • #include "readline.h" - note the quotes, rather than brackets. this means it will be sought in the the current directory, rather than in a standard place where C libraries live.

readline.h - textually included in names1.c at the point where #include was used.

  • use of extern on the prototype to indicate this function will be provided in another .c file
  • readline header comment is here, not in the .c file, so it is easily readable by users of this function.
  • use of #ifndef to protect against repeated inclusion of this file
#ifndef __READLINE_H__
#define __READLINE_H__
...
#endif //  __READLINE_H__

readline.c

  • also #include "readline.h" - not strictly necessary in this case, but it gives the compiler a chance to check that prototype (from .h file) matches the definition (from .c file).

names2.c

names2.c: (read from a file, if provided, instead of from stdin); leverages freadline.c and freadline.h

  • main takes arguments
  • code checks arguments for validity
  • use of fopen to open a file for reading ("r")
  • error messages printed to stderr with fprintf
  • fclose(fp) later called to close the file
  • freadline is like readline except it uses getc(fp) instead of getchar()
  • note the type of fp is FILE*; it’s a pointer to an object of type FILE. More on that later.