codec.base64EncodeФункция кодирует строку в формат base64, который используется для представления бинарных данных в текстовом виде, что делает их безопасными для передачи по текстовым протоколам.
Сигнатура: codec.base64Encode(str: string) -> string
Аргументы: str — произвольная строка, которую нужно закодировать в base64.
Результат: Строка, закодированная в формате base64.
Пример использования:
$encoded = codec.base64Encode("Привет!")
// $encoded будет содержать строку "0J/RgNC40LLQtdGCIQ=="
codec.base64DecodeФункция декодирует строку, закодированную в формате base64, в исходный текст. Если строка содержит символы, не входящие в стандартный алфавит base64, функция вернет nil.
Сигнатура: codec.base64Decode(str: string) -> string | nil
Аргументы: str — строка, закодированная в base64.
Результат: Исходная строка, если декодирование прошло успешно, или nil, если строка содержит недопустимые символы.
Пример использования:
$decoded = codec.base64Decode("0J/RgNC40LLQtdGCIQ==")
// $decoded будет содержать строку "Привет!"
$failed = codec.base64Decode("Привет!")
// $failed будет равен nil
codec.urlEncodeФункция кодирует строку в формат URL. Это полезно, когда необходимо передать строку в URL, так как в нем могут встречаться символы, которые имеют специальное значение (например, пробелы, амперсанды, символы пунктуации). Эти символы заменяются на соответствующие кодированные значения.
Сигнатура: codec.urlEncode(str: string) -> string
Аргументы: str — строка, которую нужно закодировать для использования в URL.
Результат: Строка, закодированная для безопасного использования в URL. Все символы, не являющиеся буквенно-цифровыми, кроме -, _, . и ~, будут заменены на знак процента (%) и соответствующие шестнадцатеричные значения.
Пример использования:
$encoded = codec.urlEncode("Привет!")
// $encoded будет содержать строку "%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82%21"
codec.urlDecodeФункция декодирует строку, закодированную в формате URL. Если строка содержит недопустимый символ после знака процента, функция вернет nil.
Сигнатура: codec.urlDecode(str: string) -> string | nil
Аргументы: str — строка, закодированная для использования в URL.
Результат: Декодированная строка, если она была корректно закодирована. В противном случае возвращается nil.
Пример использования:
$decoded = codec.urlDecode("%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82%21")
// $decoded будет содержать строку "Привет!"
$failed = codec.urlDecode("%%")
// $failed будет равен nil