Возвращает размер очереди входящих сообщений, то есть количество сообщений, отправленных пользователем.
Сигнатура: input.size() -> int
Аргументы: Отсутствуют.
Результат: Число входных сообщений, отправленных собеседником боту.
Пример использования:
$messageCount = input.size() // $messageCount равно числу сообщений, отправленных ботом
Возвращает последнее входящее сообщение, либо nil
, если очередь сообщений пуста.
Сигнатура: input.last() -> input.Message | nil
Аргументы: Отсутствуют.
Результат: Объект input.Message
, представляющий последнее сообщение, или nil
, если сообщений нет.
Пример использования:
$lastMessage = input.last() // $lastMessage содержит последнее сообщение, отправленное ботом
Возвращает первое сообщение, отправленное собеседником, либо nil
, если очередь сообщений пуста.
Сигнатура: input.first() -> input.Message | nil
Аргументы: Отсутствуют.
Результат: Объект input.Message
, представляющий первое сообщение, или nil
, если сообщений нет.
Пример использования:
$firstMessage = input.first() // $firstMessage содержит первое сообщение, отправленное ботом
Возвращает сообщение по его порядковому номеру, начиная с 0. Можно использовать отрицательные числа для отсчета с конца очереди.
Сигнатура: input.nth(index: int) -> input.Message | nil
Аргументы: index
— порядковый номер сообщения. Если число отрицательное, отсчет ведется с конца очереди.
Результат: Объект input.Message
или nil
, если указанного сообщения не существует.
Пример использования:
$message = input.nth(0) // $message содержит первое сообщение, отправленное ботом
$message = input.nth(4) // $message содержит пятое сообщение, отправленное ботом
$message = input.nth(-1) // $message содержит последнее сообщение, отправленное ботом
$message = input.nth(-3) // $message содержит третье сообщение с конца
Возвращает первое необработанное сообщение. Если таких сообщений нет или очередь пуста, возвращает nil
.
Сигнатура: input.firstUnprocessed() -> input.Message | nil
Аргументы: Отсутствуют.
Результат: Объект input.Message
с первым необработанным сообщением или nil
, если таких сообщений нет.
Пример использования:
$message = input.firstUnprocessed() // $message содержит первое необработанное сообщение
Возвращает последнее необработанное сообщение. Если таких сообщений нет или очередь пуста, возвращает nil
.
Сигнатура: input.lastUnprocessed() -> input.Message | nil
Аргументы: Отсутствуют.
Результат: Объект input.Message
с последним необработанным сообщением или nil
, если таких сообщений нет.
Пример использования:
$message = input.lastUnprocessed() // $message содержит последнее необработанное сообщение