API: Porovnání verzí

API popisuje, jak se daná funkce volá a co provede (resp. co vrátí jako výsledek). Například v [[UN*X|unixových]] systémech popisuje [[hlavičkový soubor]] <code>math.h</code> definice matematických funkcí, které jsou k dispozici v knihovně <code>libm</code> pro [[C (programovací jazyk)|programovací jazyk C]]. Hlavičkový soubor definuje prototypy funkcí, pomocí kterých je nadefinováno, jaké jsou parametry a jaké jsou návratové hodnoty (výsledky). Například [[Manuálové stránky (Unix)|manuálová stránka]] pro funkci <code>sqrt()</code> (dostupná například příkazem <code>man 3 sqrt</code>) popisuje funkci takto (zkráceno):

 

SYNTAXE

#include <math.h>

NÁVRATOVÝ KÓD

Při úspěšném výpočtu je vrácena druhá odmocnina (jestliže X je reálné a kladné).

 

Funkce tedy vrací druhou odmocninu kladného desetinného čísla (jednoduché nebo dvojnásobná přesnosti) jako desetinné číslo. API je zde tedy pro jazyk C popsáno manuálovou stránkou.