NOME

       clock - retorna o tempo de CPU

SINOPSE

       #include <time.h>

       clock_t clock(void);

DESCRIÇÃO

       A função clock() retorna uma aproximação do tempo de processamento usado pelo programa.

VALOR DE RETORNO

       O  valor  retornado  é  o  tempo  de CPU usado até o momento como um clock_t. Para obter o
       número de segundos, divida por CLOCKS_PER_SEC. Se  o  tempo  de  processador  não  estiver
       disponível ou o valor não puder ser representado, a função retorna (clock_t) -1.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).

       ┌───────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │Interface                                                      │ Atributo      │ Valor   │
       ├───────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │clock()                                                        │ Thread safety │ MT-Safe │
       └───────────────────────────────────────────────────────────────┴───────────────┴─────────┘

DE ACORDO COM

       POSIX.1-2001,   POSIX.1-2008,   C89,  C99.  XSI  exige  que  CLOCKS_PER_SEC  seja  1000000
       independente da resolução verdadeira.

NOTAS

       O padrão C permite valores arbitrários no início do programa. Use a  diferença  entre  uma
       chamada a clock() no início e outra no final do programa para obter portabilidade máxima.

       O tempo pode sofrer 'overflow'. Num sistema de 32 bits com CLOCKS_PER_SEC igual a 1000000,
       esta função retornará um valor idêntico aproximadamente a cada 72 minutos.

       Em várias outras implementações, o valor retornado por clock() também inclui  os  horários
       de todos os filhos cujo status foi coletado por wait(2) (ou outra chamada do tipo espera).
       O Linux não inclui os tempos de filhos esperados no valor retornado por clock(). A  função
       times(2),  que  retorna  explicitamente  informações  (separadas)  sobre o chamador e seus
       filhos, pode ser preferível.

       No glibc 2.17 e versões anteriores, clock()  estava  implementado  usando  times(2).  Para
       maior  precisão,  desde  o glibc 2.18, ele é implementado sobre clock_gettime(2) (usando o
       relógio CLOCK_PROCESS_CPUTIME_ID).

VEJA TAMBÉM

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

COLOFÃO

       Esta página faz parte da versão 5.13 do projeto Linux man-pages. Uma descrição do projeto,
       informações  sobre  relatórios  de  bugs  e  a  versão mais recente desta página podem ser
       encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO

       A tradução para português brasileiro desta página man foi criada por  Paulo  César  Mendes
       <drpc@ism.com.br>,   André   Luiz  Fassone  <lonely_wolf@ig.com.br>  e  Rafael  Fontenelle
       <rafaelff@gnome.org>.

       Esta tradução é uma documentação  livre;  leia  a  Licença  Pública  Geral  GNU  Versão  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  ou  posterior  para  as condições de direitos
       autorais.  Nenhuma responsabilidade é aceita.

       Se você encontrar algum erro na tradução desta página de manual, envie um  e-mail  para  a
       lista de discussão de tradutores ⟨debian-l10n-portuguese@lists.debian.org⟩.