ИМЯ

       timeradd, timersub, timercmp, timerclear, timerisset - операции со структурой timeval

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <sys/time.h>

       void timeradd(struct timeval *a, struct timeval *b,
                     struct timeval *res);
       void timersub(struct timeval *a, struct timeval *b,
                     struct timeval *res);

       void timerclear(struct timeval *tvp);
       int timerisset(struct timeval *tvp);

       int timercmp(struct timeval *a, struct timeval *b, CMP);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       Все функции, показанные выше:
           Начиная с glibc 2.19:
               _DEFAULT_SOURCE
           В версии glibc 2.19 и более ранних:
               _BSD_SOURCE

ОПИСАНИЕ

       Макросы  предназначены  для  работы  со  структурой  timeval, которая определена в <sys/time.h> следующим
       образом:

           struct timeval {
               time_t      tv_sec;     /* секунды */
               suseconds_t tv_usec;    /* микросекунды */
           };

       Макрос timeradd() складывает значения времени a и b, и помещает сумму в  timeval,  на  которую  указывает
       res. Результат нормализуется так, что значение res->tv_usec лежит в диапазоне от 0 до 999999.

       Макрос  timersub() вычитает значение времени b из a, и помещает результат в timeval, на которую указывает
       res. Результат нормализуется так, что значение res->tv_usec лежит в диапазоне от 0 до 999999.

       Макрос  timerclear()  обнуляет  структуру  timeval,  на  которую  указывает  tvp;   полученное   значение
       соответствует представлению эпохи: 1970-01-01 00:00:00 +0000 (UTC).

       Макрос  timerisset()  возвращает  истину  (не  ноль),  если  любое из полей структуры timeval, на которую
       указывает tvp, содержит ненулевое значение.

       Макрос timercmp() сравнивает значения таймера a и b с  помощью  оператора  сравнения  CMP,  и  возвращает
       истину  (не  ноль)  или  ложь  (0),  в  зависимости  от  результата  сравнения.  Некоторые системы (но не
       Linux/glibc) содержат некорректную реализацию timercmp(), в которой CMP для >=,  <=  и  ==  не  работает;
       переносимые приложения могут использовать вместо неё

           !timercmp(..., <)
           !timercmp(..., >)
           !timercmp(..., !=)

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       Макросы timerisset() и timercmp() возвращают истину (не ноль) или ложь (0).

ОШИБКИ

       Ошибок не предполагается.

СТАНДАРТЫ

       Не являются частью POSIX.1. Присутствует в вариациях BSD.

СМ. ТАКЖЕ

       gettimeofday(2), time(7)

ПЕРЕВОД

       Русский  перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry
       Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное  письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                    timeradd(3)