strscan.h

Go to the documentation of this file.

#pragma once
 
#include <cx/string/strbase.h>
 
 
 
CX_C_BEGIN
 
enum STRSC_FLAGS {
    STRSC_CaseInsensitive = 0x01,   
};
 
typedef struct strscan {
    strref s;        
    int32 pos;       
    int32 errpos;    
    bool ok;         
    flags_t flags;   
 
    // Private members - do not access directly
    int32 _len;
    int32 _spanoff;
    int32 _spanlen;
} strscan;
 
// Internal - use the strscInit() macro
void _strscInit(_Out_ strscan* _Nonnull sc, _In_opt_ strref s, flags_t flags);
 
#define strscInit(sc, s, ...) _strscInit(sc, s, opt_flags(__VA_ARGS__))
 
bool strscFinish(_Inout_ strscan* _Nonnull sc);
 
_meta_inline bool strscDone(_In_ strscan* _Nonnull sc)
{
    return sc->pos >= sc->_len;
}
 
_meta_inline int32 strscMark(_In_ strscan* _Nonnull sc)
{
    return sc->pos;
}
 
void strscRewind(_Inout_ strscan* _Nonnull sc, int32 mark);
 
bool strscSeek(_Inout_ strscan* _Nonnull sc, int32 pos);
 
void strscFail(_Inout_ strscan* _Nonnull sc);
 
 
bool strscLit(_Inout_ strscan* _Nonnull sc, _In_opt_ strref lit);
 
bool strscChar(_Inout_ strscan* _Nonnull sc, char ch);
 
bool strscTry(_Inout_ strscan* _Nonnull sc, _In_opt_ strref lit);
 
bool strscTryChar(_Inout_ strscan* _Nonnull sc, char ch);
 
bool strscPeek(_In_ strscan* _Nonnull sc, _In_opt_ strref lit);
 
uint8 strscPeekChar(_In_ strscan* _Nonnull sc);
 
bool strscWS(_Inout_ strscan* _Nonnull sc);
 
bool strscWS1(_Inout_ strscan* _Nonnull sc);
 
 
 
bool strscToken(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out, _In_opt_ strref delims);
 
bool strscUntil(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out, _In_opt_ strref text);
 
bool strscWhile(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out, _In_opt_ strref chars);
 
bool strscQuoted(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out);
 
bool strscLine(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out);
 
bool strscRest(_Inout_ strscan* _Nonnull sc, _Inout_opt_ string* out);
 
void strscSpan(_In_ strscan* _Nonnull sc, _Out_ int32* _Nonnull off, _Out_ int32* _Nonnull len);
 
 
 
_Success_(
    return) bool strscInt32(_Inout_ strscan* _Nonnull sc, _Out_ int32* _Nonnull out, int base);
 
_Success_(
    return) bool strscUInt32(_Inout_ strscan* _Nonnull sc, _Out_ uint32* _Nonnull out, int base);
 
_Success_(
    return) bool strscInt64(_Inout_ strscan* _Nonnull sc, _Out_ int64* _Nonnull out, int base);
 
_Success_(
    return) bool strscUInt64(_Inout_ strscan* _Nonnull sc, _Out_ uint64* _Nonnull out, int base);
 
_Success_(return) bool strscFloat32(_Inout_ strscan* _Nonnull sc, _Out_ float32* _Nonnull out);
 
_Success_(return) bool strscFloat64(_Inout_ strscan* _Nonnull sc, _Out_ float64* _Nonnull out);
 
_Success_(return) bool strscBool(_Inout_ strscan* _Nonnull sc, _Out_ bool* _Nonnull out);
 
// Internal - use the strscVal() macro
bool _strscVal(_Inout_ strscan* _Nonnull sc, stype st, _Out_ stgeneric* _Nonnull out);
 
#define strscVal(sc, type, pval) _strscVal(sc, stCheckedPtrArg(type, pval))
 
 
 
CX_C_END