strbase.h

Go to the documentation of this file.

#pragma once
 
 
#include <cx/cx.h>
 
CX_C_BEGIN
 
typedef struct str_ref {
    void* _is_string;
} str_ref;
 
 
typedef struct str_ref* _Nullable string;
 
typedef const struct str_ref* _Nullable strref;
 
typedef string* _Nonnull strhandle;
 
#define strInit(o) *(o) = NULL
 
void strReset(_Inout_ptr_opt_ strhandle o, uint32 sizehint);
 
void strDup(_Inout_ strhandle o, _In_opt_ strref s);
 
void strCopy(_Inout_ strhandle o, _In_opt_ strref s);
 
void strClear(_Inout_ strhandle ps);
 
_When_(s == NULL, _Post_equal_to_(0)) _Pure uint32 strLen(_In_opt_ strref s);
 
void strSetLen(_Inout_ strhandle ps, uint32 len);
 
_When_(s == NULL, _Post_equal_to_(true)) _Pure bool strEmpty(_In_opt_ strref s);
 
void strDestroy(_Inout_ strhandle ps);
 
_Ret_valid_ const char* _Nonnull strC(_In_opt_ strref s);
 
_Ret_valid_ const char* _Nonnull strPC(_Inout_ strhandle ps);
 
_Ret_valid_ uint8* _Nonnull strBuffer(_Inout_ strhandle ps, uint32 minsz);
 
uint32 strCopyOut(_In_opt_ strref s, uint32 off, _Out_writes_bytes_(bufsz) uint8* _Nonnull buf,
                  uint32 bufsz);
 
uint32 strCopyRaw(_In_opt_ strref s, uint32 off, _Out_writes_bytes_(maxlen) uint8* _Nonnull buf,
                  uint32 maxlen);
 
_Pure uint32 _strStackAllocSize(uint32 maxlen);
void _strInitStack(_Inout_ _Deref_pre_valid_ _Deref_post_opt_valid_ strhandle ps, uint32 maxlen);
 
#define strTemp(ps, maxlen)                                   \
    (*(ps)) = (string)stackAlloc(_strStackAllocSize(maxlen)); \
    _strInitStack(ps, maxlen);
 
 
#ifdef _WIN32
// definition of _S interferes with this header, so include it first
#include <mmintrin.h>
#include <wchar.h>
#endif
 
 
#define _S (string)"\xE0\xC1"
 
#define _SU (string)"\xA0\xC1"
 
#define _SO (string)"\x80\xC1"
 
 
CX_C_END