Celem jest stworzenie preprocesora dla języka C, możliwie jak najmniejszego pod względem rozmiaru kodu źródłowego w bajtach , w preferowanym języku. Jego dane wejściowe będą plikiem źródłowym typu C, a dane wyjściowe będą wstępnie przetworzonym kodem źródłowym.
Elementy, które będzie musiał przetworzyć to: Usuwanie komentarzy (linia / blok), #include directives (otwieranie plików we względnych ścieżkach i zastępowanie tekstu w wymaganym punkcie), #define, #undef, #if, #elif, #else, #endif, #ifdef, #ifndef i zdefiniowane (). Inne dyrektywy preprocesora C, takie jak #pragmas lub #errors, można zignorować.
Nie ma potrzeby obliczania wyrażeń arytmetycznych lub operatorów porównania w dyrektywach #if, zakładamy, że wyrażenie będzie miało wartość true, dopóki będzie zawierało liczbę całkowitą inną niż zero (jego główne zastosowanie będzie dotyczyło dyrektywy zdefiniowanej ()). Przykłady możliwych danych wejściowych i wyjściowych (możliwe dodatkowe spacje w plikach wyjściowych zostały przycięte dla lepszego wyglądu, nie ma potrzeby, aby kod to robił). Program zdolny do prawidłowego przetworzenia poniższych przykładów zostanie uznany za wystarczający.
----Input file: foo.c (main file being preprocessed)
#include "bar.h" // Line may or may not exist
#ifdef NEEDS_BAZZER
#include "baz.h"
#endif // NEEDS_BAZZER
#ifdef _BAZ_H_
int main(int argc, char ** argv)
{
/* Main function.
In case that bar.h defined NEEDS_BAZ as true,
we call baz.h's macro BAZZER with the length of the
program's argument list. */
return BAZZER(argc);
}
#elif defined(_BAR_H_)
// In case that bar.h was included but didn't define NEEDS_BAZ.
#undef _BAR_H_
#define NEEDS_BARRER
#include "bar.h"
int main(int argc, char ** argv)
{
return BARRER(argc);
}
#else
// In case that bar.h wasn't included at all.
int main()
{return 0;}
#endif // _BAZ_H_
----Input file bar.h (Included header)
#ifndef _BAR_H_
#define _BAR_H_
#ifdef NEEDS_BARRER
int bar(int * i)
{
*i += 4 + *i;
return *i;
}
#define BARRER(i) (bar(&i), i*=2, bar(&i))
#else
#define NEEDS_BAZZER // Line may or may not exist
#endif // NEEDS_BARRER
#endif // _BAR_H_
----Input file baz.h (Included header)
#ifndef _BAZ_H_
#define _BAZ_H_
int baz(int * i)
{
*i = 4 * (*i + 2);
return *i;
}
#define BAZZER(i) (baz(&i), i+=2, baz(&i))
#endif // _BAZ_H_
----Output file foopp.c (no edits)
int baz(int * i)
{
*i = 4 * (*i + 2);
return *i;
}
int main(int argc, char ** argv)
{
return (baz(&argc), argc+=2, baz(&argc));
}
----Output file foopp2.c (with foo.c's first line removed)
int main()
{return 0;}
----Output file foopp3.c (with bar.h's line "#define NEEDS_BAZZER" removed)
int bar(int * i)
{
*i += 4 + *i;
return *i;
}
int main(int argc, char ** argv)
{
return (bar(&argc), argc*=2, bar(&argc));
}
#if
trzeba wspierać? tzn. czy preprocesor musi obsługiwać wyrażenia za pomocą operacji arytmetycznych, bitowych itp.?