~~NOTOC~~









===== tn_event_clear() =====

Функция предназначена для сброса битов в битовой маске флага ''evf''. Биты сбрасываются по логическому И с параметром-маской ''pattern''.

Этот сервис не предназначен для запуска задач, ожидающих определенную битовую маску. Его можно использовать для сброса события в задаче, ожидавшей флаг.

**Вызов:**
<code cpp>
TN_RETVAL tn_event_clear (TN_EVENT *evf, TN_UWORD pattern);
</code>

**Разрешен вызов:** \\ 

В контексте задачи

**Параметры функции:**

  ; ''evf'' : указатель на объект типа флаг
  ; ''pattern'' : сбрасываемые биты в битовой маске флага. //Замечание:// сбрасываемые биты должны быть равны 0, параметр ''pattern'' не должен принимать значения ''0xFFFF''. Например, если битовая маска флага до вызова сервиса была равна ''0b0011001101010101'', а параметр ''pattern'' равен ''0b11<color blue>**00**</color>111111111111'', то битовая маска флага станет равна ''0b00<color blue>**00**</color>001101010101''

\\ 


**Возвращаемые значения:**  

  ; ''TERR_WRONG_PARAM'' : некорректное значение параметра (__замечание:__ данный код возврата возможен только в случае использования сервисов с проверкой параметров)
  ; ''TERR_NOEXS'' : попытка изменения объекта, не являющегося флагом (__замечание:__ данный код возврата возможен только в случае использования сервисов с проверкой параметров)
  ; ''TERR_WCONTEXT'' : попытка вызова сервиса в пользовательской критической секции или в прерывании
  ; ''TERR_NO_ERR'' : успешное выполнение

\\ 
**Пример вызова:**  
<code cpp>
TN_EVENT event;

tn_event_clear(&event, ~(0x8000));
</code>

\\ 

----
[[tnkernel:ref:event:intro#Сервисы управления флагами|К списку сервисов]]