NAZWA

       clock - wyznaczanie czasu procesora

SKŁADNIA

       #include <time.h>

       clock_t clock(void);

OPIS

       Funkcja clock() zwraca przybliżoną ilość czasu procesora wykorzystanego przez program.

WARTOŚĆ ZWRACANA

       Zwracana  wartość  to  ilość  czasu CPU wykorzystanego do tej pory w formacie clock_t. Aby
       otrzymać czas w sekundach, należy podzielić go przez CLOCKS_PER_SEC.  Jeśli  informacja  o
       wykorzystanym  czasie  procesora  jest  niedostępna lub wartość tego czasu nie może zostać
       przedstawiona, zwracana jest wartość (clock_t) -1.

ATRYBUTY

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

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

ZGODNE Z

       POSIX.1-2001,  POSIX.1-2008,  C89, C99. XSI wymaga, aby CLOCKS_PER_SEC było równe 1000000,
       niezależnie od rzeczywistej rozdzielczości.

UWAGI

       Standard C dopuszcza nieokreśloną wartość na początku programu.  Aby  zapewnić  maksymalną
       przenośność,  należy  odjąć  od  wyniku funkcji wartość zwróconą przez clock() na początku
       programu.

       Należy  zauważyć,  że  zegar  może  się  przekręcić.  W   systemach   32-bitowych,   gdzie
       CLOCKS_PER_SEC  wynosi  1000000,  funkcja  ta  będzie  zwracać tę samą wartość co około 72
       minuty.

       W niektórych innych implementacjach wartość zwracana przez clock() zawiera  również  czasy
       procesów potomnych, których kod zakończenia został odczytany za pomocą wait(2) (lub innego
       programu typu "wait"). Linux nie dołącza do wartości  zwracanej  clock()  czasów  procesów
       potomnych,  na  których  zakończenie  oczekiwano.  Funkcja  times(2),  zwracająca (osobne)
       informacje o procesie macierzystym i o jego potomkach, może być bardziej pożądana.

       W glibc 2.17 i wcześniejszych clock() był implementowany za pomocą times(2). Aby zwiększyć
       dokładność,  od  wersji  glibc  2.18  jest implementowany za pomocą clock_gettime(2) (przy
       użyciu zegara CLOCK_PROCESS_CPUTIME_ID).

ZOBACZ TAKŻE

       clock_gettime(2), getrusage(2), times(2)

O STRONIE

       Angielska wersja tej strony  pochodzi  z  wydania  5.13  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   są:   Adam   Byrtek
       <alpha@irc.pl>,   Andrzej   Krzysztofowicz   <ankry@green.mf.pg.gda.pl>,   Robert  Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe  informacje  o  warunkach  licencji
       można   uzyskać   zapoznając   się   z   GNU   General   Public   License   w   wersji   3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  lub  nowszej.  Nie   przyjmuje   się   ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy  w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres listy dyskusyjnej
       ⟨manpages-pl-list@lists.sourceforge.net⟩.