Перейти к содержимому
Dialova

Документация IRC · Продвинутый

Как читать и разбирать сообщение IRC

Сообщение IRC заканчивается CRLF. Оно может содержать теги, источник, команду и параметры. В TCP полученная порция данных не обязательно является полной строкой: сначала нужно выделить сообщения, затем их интерпретировать.

Команда Dialova · Проверено

Разобрать строку на части #

Пример сообщения без завершающего CRLF
@time=2026-10-29T10:00:00.000Z :Alice!alice@cloak.example PRIVMSG #atelier :Bonjour tout le monde
ЧастьЗначение в примереНазначение
Теги@time=…Метаданные перед первым разделяющим пробелом.
Источник / префикс:Alice!alice@cloak.exampleАвтор, указанный сервером.
КомандаPRIVMSGДействие протокола.
Параметр получателя#atelierНазначение сообщения.
Последний параметр:Bonjour tout le mondeПараметр с пробелами; двоеточие не входит в текст.

Пробелы и последний параметр #

Основной разделитель — пробел ASCII. Последний параметр может начинаться двоеточием; всё после него, включая пробелы, относится к этому параметру. Простое разделение всей строки по пробелам потеряет эту структуру.

Три разных сообщения, каждое заканчивается CRLF
TOPIC #atelier :
PRIVMSG Bob :текст с пробелами
PING :jeton-123

В первом примере последний параметр пустой, во втором содержит текст с пробелами. Метки направления C/S из других примеров руководства никогда не входят в отправляемые байты.

Длина, байты и кодировка #

Исторический предел сообщения IRC — 512 байт вместе с CRLF. Это не 512 символов: один символ UTF-8 может занимать несколько байт. Для тегов IRCv3 есть дополнительные собственные ограничения, не делающие остальное сообщение бесконечным.

Исторический IRC не гарантирует единой кодировки всего текста. Современные клиенты и сети часто используют UTF-8, а значения тегов IRCv3 должны быть в UTF-8. Учитывайте политику сети и обработку некорректных данных. Не придумывайте автоматического согласования кодировки.

Надёжный парсер #

  • Накапливать байты до полного окончания и сохранять оставшийся фрагмент.
  • Обрабатывать несколько строк в одном чтении и одну строку в нескольких чтениях.
  • Ограничивать память, не ожидая конца строки бесконечно.
  • Выделить и декодировать теги, затем источник, команду и параметры.
  • Не применять историческое событие как изменение текущего состояния.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.