Przejdź do treści
Dialova

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 #

Przykładowa wiadomość; końcowe CRLF pominięto
@time=2026-10-29T10:00:00.000Z :Alice!alice@cloak.example PRIVMSG #atelier :Bonjour tout le monde
CzęśćWartość w przykładzieZadanie
Znaczniki@time=…Metadane przed pierwszą spacją rozdzielającą.
Źródło / prefiks:Alice!alice@cloak.exampleAutor wskazany przez serwer.
PoleceniePRIVMSGDziałanie protokołu.
Parametr celu#atelierOdbiorca.
Ostatni parametr:Bonjour tout le mondeParametr 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ę.

Trzy osobne wiadomości, każda zakończona CRLF
TOPIC #atelier :
PRIVMSG Bob :tekst ze spacjami
PING :jeton-123

Pierwszy 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.