strencoding.h

#pragma once
 
#include <cx/string/strbase.h>
 
 
CX_C_BEGIN
 
_When_(s == NULL, _Post_equal_to_(false)) bool strValidUTF8(_In_opt_ strref s);
 
_When_(s == NULL, _Post_equal_to_(false)) bool strValidASCII(_In_opt_ strref s);
 
uint32 strU8Len(_In_opt_ strref s);
 
int32 strU8Offset(_In_opt_ strref s, int32 charIdx);
 
bool strSanitizeUTF8(_Inout_ strhandle o, _In_opt_ strref s);
 
bool strSubStrU8(_Inout_ strhandle o, _In_opt_ strref s, int32 b, int32 e);
 
size_t strToUTF16(_In_opt_ strref s, _Out_writes_opt_(wsz) uint16* _Nullable buf, size_t wsz);
 
_Ret_opt_valid_ uint16* _Nullable strToUTF16A(_In_opt_ strref s);
 
_Ret_opt_valid_ uint16* _Nullable strToUTF16S(_In_opt_ strref s);
 
bool strFromUTF16(_Inout_ strhandle o, _In_reads_(wsz) const uint16* _Nonnull buf, size_t wsz);
 
bool strB64Encode(_Inout_ strhandle out, _In_reads_bytes_(sz) const uint8* _Nonnull buf, uint32 sz,
                  bool urlsafe);
 
uint32 strB64Decode(_In_opt_ strref s, _Out_writes_bytes_opt_(sz) uint8* _Nullable buf, uint32 sz);
 
bool strHexEncode(_Inout_ strhandle out, _In_reads_bytes_(sz) const uint8* _Nonnull buf, uint32 sz,
                  bool upper);
 
uint32 strHexDecode(_In_opt_ strref s, _Out_writes_bytes_opt_(sz) uint8* _Nullable buf, uint32 sz);
 
 
CX_C_END