oracular (3) clock.3.gz

Provided by: manpages-pt-br-dev_4.23.1-1_all bug

NOME

       clock - retorna o tempo de CPU

BIBLIOTECA

       Biblioteca C Padrão (libc, -lc)

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).

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

VERSÕES

       XSI requires that CLOCKS_PER_SEC equals 1000000 independent of the actual resolution.

       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.

PADRÕES

       C11, POSIX.1-2008.

HISTÓRICO

       POSIX.1-2001, C89.

       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).

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.

VEJA TAMBÉM

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

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⟩.