C- Präprozessor Direktiven

[Dustin M. (db1234)]

Guten Tag,

ich bin auf folgendes Problem gestoßen:

- Header-Datei

#define API
API int foo1();
API int foo2();
API int foo3();

In der c-Datei sind die Funktionen ganz normal aufgeführt
- Source-Datei

int foo1()
{
}
int foo2()
{
}
int foo3()
{
}

Ich bin mir nicht ganz über die Bedeutung der Codezeilen 2,3,4 
(Header-Datei) im klaren, bzw. welchen Nutzen man daraus ziehen kann. 
Warum wurde das so gemacht?

Für mich sind es Funktionsprototypen, die als Makro hinterlegt ist.

Ich denke die Erklärung ist einfach, ich bedanke mich schonmal für eine 
Antwort :)

[🐧 DPA 🐧 (Gast)]

Das Macro ist nur das "API" das bei dem define ja einfach weg kommt. 
Macht also nichts.

Sowas kann aber trotzdem für diverses nützlich sein. Man sieht z.B. so 
sehr einfach, welche Funktionen teil der API sind. Dann kann man z.B. 
auch einfach nach "API" greppen.

Man kann so auch einfach was vor alle Funktionen schreiben.
Es ist z.B. nicht unüblich, bei Libraries noch ein __declspec(dllexport) 
vor exportierte Funktionen davorzusetzen, das macht man dann gerne mit 
einem define. Unter linux / ELF mach ich sowas auch gerne 
"-fvisibility=hidden" und "__attribute__((visibility("default")))". 
Manchmal mache ich Symbole auch weak, wenn sie überschreibbar oder 
optional sein sollen und so zeug, und packe das dann in ein Macro. So 
ein Macro kann man auch Platformabhängig definieren, indem man es in 
#ifdef #endif packt.

[🐧 DPA 🐧 (Gast)]

Es könnte auch zu Dokumentationszwecken in einer generierten Codedoku 
dienen.

[g457 (Gast)]

> Warum wurde das so gemacht?

Weil der Autor kein C kann. Korrekt wäre eher

API int foo1(void);

..etc.

> Für mich sind es Funktionsprototypen, [..]

Sind es auch.

> [..] die als Makro hinterlegt ist.

? Störst Du dich an dem 'API'? Damit kann man sehr einfach und zentral 
alle im Header veröffentlichten Funktionen gemeinsam und einheitlich 
umdeklarieren.