Man page - clock(3)

Packages contains this manual

Available languages:

en fr pt_BR es pl ja ru ro de

Manual

clock

NOME
BIBLIOTECA
SINOPSE
DESCRIÇÃO
VALOR DE RETORNO
ATRIBUTOS
VERSÕES
PADRÕES
HISTÓRICO
NOTAS
VEJA TAMBÉM
TRADUÇÃO

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

Image grohtml-3937349-1.png

VERSÕES

XSI exige que CLOCKS_PER_SEC seja 1000000 independentemente da resolução verdadeira.

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