NAZWA

       assert - przerwanie pracy programu, jeśli wyrażenie jest fałszywe

SKŁADNIA

       #include <assert.h>

       void assert(scalar wyrażenie);

OPIS

       To  makro  może pomóc programistom znajdować błędy w ich programach lub obsługiwać wyjątki
       przez wywołanie awarii zapewniającej ograniczone wyjście debugowania.

       Jeśli wyrażenie jest fałszywe (to jest równe zeru), assert() wyświetli błąd na standardowe
       wyjście błędów i przerywa pracę programu przez wywołanie abort(3). Komunikat błędu zawiera
       nazwę pliku i funkcji zawierającej wywołanie assert(), numer  wiersza  kodu  źródłowego  z
       wywołaniem i tekst argumentu np.:

           prog: some_file.c:16: some_func: Assertion `val == 0' failed.

       Jeśli  w momencie ostatniego włączenia pliku <assert.h> było zdefiniowane makro NDEBUG, to
       makro assert() nie generuje żadnego kodu, więc w  ogóle  nic  nie  robi.  Nie  zaleca  się
       definiowania  NDEBUG  przy używaniu assert() do wykrywania błędów, ponieważ oprogramowanie
       może zachowywać się nieprzewidywalnie.

WARTOŚĆ ZWRACANA

       Nie jest zwracana żadna wartość.

ATRYBUTY

       Informacje  o  pojęciach  używanych  w  tym  rozdziale   można   znaleźć   w   podręczniku
       attributes(7).

       ┌──────────┬────────────────────────┬─────────┐
       │Interfejs │ Atrybut                │ Wartość │
       ├──────────┼────────────────────────┼─────────┤
       │assert()  │ Bezpieczeństwo wątkowe │ MT-Safe │
       └──────────┴────────────────────────┴─────────┘

ZGODNE Z

       POSIX.1-2001,  POSIX.1-2008,  C89,  C99.  W  C89 wyrażenie musi być typu int, w przeciwnym
       wypadku zachowanie funkcji jest nieokreślone, jednakże  w  C99  może  być  dowolnego  typu
       skalarnego.

BŁĘDY

       assert()  jest  zaimplementowane  jako  makro.  Jeśli testowane wyrażenie ma jakieś efekty
       uboczne,  zachowanie  programu  będzie  różne  w  zależności  od  tego,  czy  zdefiniowano
       makrodefinicję     NDEBUG.     Może     to     prowadzić     do     Heisenbugów    [patrz:
       http://pl.wikipedia.org/wiki/Heisenbug - przyp.tłum.], które nie występują przy  włączonym
       odpluskwianiu.

ZOBACZ TAKŻE

       abort(3), assert_perror(3), exit(3)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  4.07  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów oraz  najnowszą  wersję  oryginału  można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia  niniejszej  strony podręcznika man są: Adam Byrtek (PTM)
       <abyrtek@priv.onet.pl>, Andrzej Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie  tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
       stronie  http://sourceforge.net/projects/manpages-pl/.  Jest   zgodne   z   wersją    4.07
       oryginału.