====== OSA : OS_Wait_TO ======
<color blue>**OS_Wait_TO (condition, timeout)**</color>\\ 
=== ===

{{osa:ref:attr_call_task.png|Разрешен вызов только в контексте задачи}}{{osa:ref:attr_call_ct_sw.png|Переключает контекст}}{{osa:ref:attr_call_to.png|Сервис использует таймаут}}

Переводит задачу в режим ожидания до тех пор, пока не будет выполнено заданное условие или не пройдет время, укзаанное параметром //timeout//. Условием //condition// в данном случае может быть любое выражение перечислимого типа (bool, char, int и т.д.). Как только условие выполняется, задача переходит в состояние готовности и, как только задача становится самой приоритетной из всех готовых, она получает управление. Исключение - [[osa:ref:description:events_and_priority#Состязания приоритетов|состязяние приоритетов]].



=== Разрешен вызов: ===
Только из задачи


=== Параметры функции: ===
{| class = "fpl"
|-
|//''condition''//
|Любое выражение перечислимого типа.
|-
|//''timeout''//
|Время ожидания. Задается в системных тиках - периодах вызова сервиса ##[[osa:ref:allservices:OS_Timer|OS_Timer]]##
|}


=== Возвращаемое значение: ===
{| class = "fpl"
|-
|//''таймаут''//
|Если вышли из ожидания по таймауту, то сервис ##[[osa:ref:allservices:OS_IsTimeout|OS_IsTimeout]]## возвратит **true**
|}


=== Пример вызова: ===
<code cpp>
void Task (void)
{
    char b;
    for (;;) {
        /*...*/
        OS_Wait_TO (RCIF, 100);   // Ждем 100 мс, когда придет байт по USART
        if (!OS_IsTimeout()) {
            b = RCREG;
        }
        /*...*/
    }
}
</code>


=== Old style name ===
<color gray>**OS_WaitConditionTimeout**</color>\\ 






<color gray>**OS_Cond_Wait_TO**</color>\\ 









=== См. также ===

----
  * [[osa:ref:services:alphabetical|Алфавитный указатель]]
  * [[osa:ref:services:brieflist|Все сервисы]]
~~UP~~