Dokumentacja IRC · Zaawansowany
Odczytywanie i analizowanie wiadomości IRC
Wiadomość IRC kończy się CRLF. Może zawierać znaczniki, źródło, polecenie i parametry. W TCP odebrany fragment danych nie musi być pełną linią: najpierw trzeba wydzielić wiadomości, a potem je interpretować.
Zespół Dialovy · Sprawdzono
Budowa linii #
@time=2026-10-29T10:00:00.000Z :Alice!alice@cloak.example PRIVMSG #atelier :Bonjour tout le monde| Część | Wartość w przykładzie | Zadanie |
|---|---|---|
| Znaczniki | @time=… | Metadane przed pierwszą spacją rozdzielającą. |
| Źródło / prefiks | :Alice!alice@cloak.example | Autor wskazany przez serwer. |
| Polecenie | PRIVMSG | Działanie protokołu. |
| Parametr celu | #atelier | Odbiorca. |
| Ostatni parametr | :Bonjour tout le monde | Parametr zawierający spacje; dwukropek nie jest częścią tekstu. |
Spacje i ostatni parametr #
Podstawowym separatorem jest spacja ASCII. Ostatni parametr może zaczynać się dwukropkiem; wszystko za nim, także spacje, należy do tego parametru. Proste podzielenie całej linii według spacji zgubiłoby tę informację.
TOPIC #atelier :
PRIVMSG Bob :tekst ze spacjami
PING :jeton-123Pierwszy przykład ma pusty ostatni parametr, a drugi zawiera tekst ze spacjami. Oznaczenia kierunku C/S używane w innych przykładach nigdy nie należą do wysyłanych bajtów.
Długość, bajty i kodowanie #
Historyczny limit wiadomości IRC wynosi 512 bajtów łącznie z CRLF. Nie chodzi o 512 znaków: znak UTF-8 może zajmować kilka bajtów. Znaczniki IRCv3 mają dodatkowe, własne limity, które nie pozwalają dowolnie wydłużać reszty wiadomości.
Historyczny IRC nie gwarantuje jednego kodowania wszystkich tekstów. Współczesne sieci i klienci często używają UTF-8, a wartości znaczników IRCv3 muszą mieć to kodowanie. Sprawdź politykę sieci i obsługę nieprawidłowych danych; nie zakładaj automatycznego negocjowania kodowania.
Odporny parser #
- Zbieraj bajty do pełnego zakończenia linii i zachowuj pozostały fragment.
- Obsługuj kilka linii w jednym odczycie sieciowym i linię podzieloną między odczyty.
- Ogranicz pamięć zamiast bez końca czekać na koniec linii.
- Wydziel i zdekoduj znaczniki, a następnie źródło, polecenie i parametry.
- Nie wykonuj zdarzenia historycznego jako zmiany bieżącego stanu.
Źródła i weryfikacja
Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.
- Modern IRC — specyfikacja protokołu klienta ↗Źródło specyfikacji · dostęp 2026-10-29
- RFC 2812 — protokół klienta (2000) ↗Źródło historyczne · dostęp 2026-10-29
- IRCv3 — znaczniki wiadomości ↗Źródło specyfikacji · dostęp 2026-10-29