Moduł:Sandbox/Ksawi999/Koduj/opis

Wersja z dnia 14:47, 12 mar 2021 autorstwa Ksawi999 (dyskusja | edycje) (Utworzono nową stronę "{{Dokumentacja/Nagłówek}} Moduł służy do kodowania i dekodowania tekstu. Posiada on dwie funkcje: code (kodującą) i decode (dekodującą). Szablon implementujący...")
(różn.) ← poprzednia wersja | przejdź do aktualnej wersji (różn.) | następna wersja → (różn.)
To jest strona dokumentacji, będzie ona dołączona na stronie głównej. Aby uzyskać więcej informacji sprawdź Szablon:Dokumentacja.

Moduł służy do kodowania i dekodowania tekstu. Posiada on dwie funkcje: code (kodującą) i decode (dekodującą). Szablon implementujący ten moduł posiada również funkcję repair, która pozwala na "naprawienie" kodu przestarzałego lub zakodowanego w inny sposób. Pierwszy parametr (po nazwie funkcji) to tekst, który moduł ma zakodować, drugi parametr to klucz kodowania, a trzeci, opcjonalny parametr dotyczy sposobu kodowania (c, / lub * i ich dowolne kombinacje) i nie będzie uwzględniony przy dekodowaniu (aby rozkodować tekst nie trzeba pamiętać jakim sposobem się go zakodowało). Sposób kodowania "c" optymalizuje tekst do skopiowania i użycia w innym, niezależnym szablonie (zamienia | na | i = na =). Sposób kodowania "/" dodaje do zakodowanego tekstu rozdzielacze (//) w miejscach, w których występujące po sobie znaki tworzą tekst, który może zaburzyć działanie szablonu (podwójne nawiasy klamrowe) lub jest znakiem specjalnym (// lub **). Sposób kodowania "*" pozwala na zakodowanie znaków, których kod ASCII jest większy niż 126, np. polskich znaków. Kolejność znaków odpowiadających sposobie kodowania nie ma znaczenia.