.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Sat Jul 24 21:27:01 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 14 Jun 2002, Michael Kerrisk .\" Added notes on differences from other UNIX systems with respect to .\" waited-for children. .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH clock 3 "20 julho 2023" "Linux man\-pages 6.05.01" .SH NOME clock \- retorna o tempo de CPU .SH BIBLIOTECA Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSE .nf \fB#include \fP .PP \fBclock_t clock(void);\fP .fi .SH DESCRIÇÃO A função \fBclock\fP() retorna uma aproximação do tempo de processamento usado pelo programa. .SH "VALOR DE RETORNO" O valor retornado é o tempo de CPU usado até o momento como um \fBclock_t\fP. Para obter o número de segundos, divida por \fBCLOCKS_PER_SEC\fP. Se o tempo de processador não estiver disponível ou o valor não puder ser representado, a função retorna \fI(clock_t)\ \-1\fP. .SH ATRIBUTOS Para uma explicação dos termos usados nesta seção, consulte \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Atributo Valor T{ .na .nh \fBclock\fP() T} Thread safety MT\-Safe .TE .sp 1 .SH VERSÕES XSI requires that \fBCLOCKS_PER_SEC\fP equals 1000000 independent of the actual resolution. .PP .\" I have seen this behavior on Irix 6.3, and the OSF/1, HP/UX, and .\" Solaris manual pages say that clock() also does this on those systems. .\" POSIX.1-2001 doesn't explicitly allow this, nor is there an .\" explicit prohibition. -- MTK Em várias outras implementações, o valor retornado por \fBclock\fP() também inclui os horários de todos os filhos cujo status foi coletado por \fBwait\fP(2) (ou outra chamada do tipo espera). O Linux não inclui os tempos de filhos esperados no valor retornado por \fBclock\fP(). A função \fBtimes\fP(2), que retorna explicitamente informações (separadas) sobre o chamador e seus filhos, pode ser preferível. .SH PADRÕES C11, POSIX.1\-2008. .SH HISTÓRICO POSIX.1\-2001, C89. .PP No glibc 2.17 e versões anteriores, \fBclock\fP() estava implementado usando \fBtimes\fP(2). Para maior precisão, desde o glibc 2.18, ele é implementado sobre \fBclock_gettime\fP(2) (usando o relógio \fBCLOCK_PROCESS_CPUTIME_ID\fP). .SH NOTAS O padrão C permite valores arbitrários no início do programa. Use a diferença entre uma chamada a \fBclock\fP() no início e outra no final do programa para obter portabilidade máxima. .PP O tempo pode sofrer 'overflow'. Num sistema de 32 bits com \fBCLOCKS_PER_SEC\fP igual a 1000000, esta função retornará um valor idêntico aproximadamente a cada 72 minutos. .SH "VEJA TAMBÉM" \fBclock_gettime\fP(2), \fBgetrusage\fP(2), \fBtimes\fP(2) .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Paulo César Mendes , André Luiz Fassone e Rafael Fontenelle . . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .