from_chars: generalized chars to value

Read a value from the string, which must be trimmed to the value (ie, no leading/trailing whitespace). More...

Modules
	from_chars_first: generalized chars to value
	Read the first valid sequence of characters from the string, skipping leading whitespace, and convert it using from_chars: generalized chars to value .

Functions
bool	c4::from_chars (csubstr buf, uint8_t *v) noexcept
bool	c4::from_chars (csubstr buf, uint16_t *v) noexcept
bool	c4::from_chars (csubstr buf, uint32_t *v) noexcept
bool	c4::from_chars (csubstr buf, uint64_t *v) noexcept
bool	c4::from_chars (csubstr buf, int8_t *v) noexcept
bool	c4::from_chars (csubstr buf, int16_t *v) noexcept
bool	c4::from_chars (csubstr buf, int32_t *v) noexcept
bool	c4::from_chars (csubstr buf, int64_t *v) noexcept
bool	c4::from_chars (csubstr buf, float *v) noexcept
bool	c4::from_chars (csubstr buf, double *v) noexcept
template<class T >
auto	c4::from_chars (csubstr buf, T *v) noexcept -> bool ::type
template<class T >
bool	c4::from_chars (csubstr buf, T **v) noexcept
bool	c4::from_chars (csubstr buf, bool *v) noexcept
bool	c4::from_chars (csubstr buf, char *v) noexcept
	extract a single character from a substring More...
bool	c4::from_chars (csubstr buf, csubstr *v) noexcept
bool	c4::from_chars (csubstr buf, substr *v) noexcept
template<class T >
bool	c4::from_chars (csubstr s, fmt::overflow_checked_< T > wrapper)
	read an integer type, detecting overflow (returns false on overflow) More...
template<class T >
bool	c4::from_chars (csubstr s, fmt::overflow_checked_< T > *wrapper)
	read an integer type, detecting overflow (returns false on overflow) More...
bool	c4::from_chars (csubstr buf, fmt::raw_wrapper *r)
	read a variable in raw binary format, using memcpy More...
bool	c4::from_chars (csubstr buf, fmt::raw_wrapper r)
	read a variable in raw binary format, using memcpy More...
size_t	c4::from_chars (csubstr buf, fmt::base64_wrapper *b)
	read a variable in base64 format More...
size_t	c4::from_chars (csubstr buf, fmt::base64_wrapper const &b)
	read a variable in base64 format More...

Detailed Description

Read a value from the string, which must be trimmed to the value (ie, no leading/trailing whitespace).

return true if the conversion succeeded. There is no check for overflow; the value wraps around in a way similar to the standard C/C++ overflow behavior. For example, from_chars<int8_t>("128", &val) returns true and val will be set tot 0. See overflows: does a number string overflow a type and Check read for overflow for facilities enforcing no-overflow.

Dispatches to the most appropriate and efficient conversion function

See also

from_chars_first: generalized chars to value, atou, atoi, atof, atod

Function Documentation

from_chars() [1/22]

bool c4::from_chars ( csubstr  buf, uint8_t *  v  )

inlinenoexcept

Definition at line 2368 of file charconv.hpp.

{ return atou(buf, v); }

from_chars() [2/22]

bool c4::from_chars ( csubstr  buf, uint16_t *  v  )

inlinenoexcept

Definition at line 2369 of file charconv.hpp.

{ return atou(buf, v); }

from_chars() [3/22]

bool c4::from_chars ( csubstr  buf, uint32_t *  v  )

inlinenoexcept

Definition at line 2370 of file charconv.hpp.

{ return atou(buf, v); }

from_chars() [4/22]

bool c4::from_chars ( csubstr  buf, uint64_t *  v  )

inlinenoexcept

Definition at line 2371 of file charconv.hpp.

{ return atou(buf, v); }

from_chars() [5/22]

bool c4::from_chars ( csubstr  buf, int8_t *  v  )

inlinenoexcept

Definition at line 2372 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [6/22]

bool c4::from_chars ( csubstr  buf, int16_t *  v  )

inlinenoexcept

Definition at line 2373 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [7/22]

bool c4::from_chars ( csubstr  buf, int32_t *  v  )

inlinenoexcept

Definition at line 2374 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [8/22]

bool c4::from_chars ( csubstr  buf, int64_t *  v  )

inlinenoexcept

Definition at line 2375 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [9/22]

bool c4::from_chars ( csubstr  buf, float *  v  )

inlinenoexcept

Definition at line 2376 of file charconv.hpp.

{ return atof(buf, v); }

from_chars() [10/22]

bool c4::from_chars ( csubstr  buf, double *  v  )

inlinenoexcept

Definition at line 2377 of file charconv.hpp.

{ return atod(buf, v); }

from_chars() [11/22]

template<class T >

auto c4::from_chars ( csubstr  buf, T *  v  ) -> bool ::type

inlinenoexcept

Definition at line 2379 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [12/22]

template<class T >

bool c4::from_chars ( csubstr  buf, T **  v  )

inlinenoexcept

Definition at line 2382 of file charconv.hpp.

{ intptr_t tmp; bool ret = from_chars(buf, &tmp); if(ret) { *v = (T*)tmp; } return ret; }

from_chars() [13/22]

bool c4::from_chars ( csubstr  buf, bool *  v  )

inlinenoexcept

Definition at line 2451 of file charconv.hpp.

{
    if(buf.len == 1)
    {
        if(buf.str[0] == '0')
        {
            *v = false; return true;
        }
        else if(buf.str[0] == '1')
        {
            *v = true; return true;
        }
    }
    else if(buf.len == 4)
    {
        if(((buf.str[0] == 't') && (0 == memcmp(buf.str + 1, "rue", 3)))
           ||
           ((buf.str[0] == 'T') && ((0 == memcmp(buf.str + 1, "rue", 3) ||
                                     0 == memcmp(buf.str + 1, "RUE", 3)))))
        {
            *v = true; return true;
        }
    }
    else if(buf.len == 5)
    {
        if(((buf.str[0] == 'f') && (0 == memcmp(buf.str + 1, "alse", 4)))
           ||
           ((buf.str[0] == 'F') && ((0 == memcmp(buf.str + 1, "alse", 4) ||
                                     0 == memcmp(buf.str + 1, "ALSE", 4)))))
        {
            *v = false; return true;
        }
    }
    // fallback to c-style int bools
    int val = 0;
    bool ret = from_chars(buf, &val);
    if(C4_LIKELY(ret))
    {
        *v = (val != 0);
    }
    return ret;
}

from_chars() [14/22]

bool c4::from_chars ( csubstr  buf, char *  v  )

inlinenoexcept

extract a single character from a substring

Note

to extract a string instead and not just a single character, use the csubstr overload

Definition at line 2522 of file charconv.hpp.

{
    if(buf.len != 1)
        return false;
    C4_XASSERT(buf.str);
    *v = buf.str[0];
    return true;
}

from_chars() [15/22]

bool c4::from_chars ( csubstr  buf, csubstr *  v  )

inlinenoexcept

Definition at line 2562 of file charconv.hpp.

{
    *v = buf;
    return true;
}

from_chars() [16/22]

bool c4::from_chars ( csubstr  buf, substr *  v  )

inlinenoexcept

Definition at line 2600 of file charconv.hpp.

{
    C4_ASSERT(!buf.overlaps(*v));
    // is the destination buffer wide enough?
    if(v->len >= buf.len)
    {
        // calling memcpy with zero len is undefined behavior
        // and will wreak havoc in calling code's branches.
        // see https://github.com/biojppm/rapidyaml/pull/264#issuecomment-1262133637
        if(buf.len)
        {
            C4_ASSERT(buf.str != nullptr);
            C4_ASSERT(v->str != nullptr);
            memcpy(v->str, buf.str, buf.len);
        }
        v->len = buf.len;
        return true;
    }
    return false;
}

from_chars() [17/22]

template<class T >

bool c4::from_chars ( csubstr  s, fmt::overflow_checked_< T >  wrapper  )

inline

read an integer type, detecting overflow (returns false on overflow)

Definition at line 326 of file format.hpp.

{
    if(C4_LIKELY(!overflows<T>(s)))
        return atox(s, wrapper.val);
    return false;
}

from_chars() [18/22]

template<class T >

bool c4::from_chars ( csubstr  s, fmt::overflow_checked_< T > *  wrapper  )

inline

read an integer type, detecting overflow (returns false on overflow)

Definition at line 335 of file format.hpp.

{
    if(C4_LIKELY(!overflows<T>(s)))
        return atox(s, wrapper->val);
    return false;
}

from_chars() [19/22]

bool c4::from_chars	(	csubstr	buf,
		fmt::raw_wrapper *	r
	)

read a variable in raw binary format, using memcpy

from_chars() [20/22]

bool c4::from_chars ( csubstr  buf, fmt::raw_wrapper  r  )

inline

read a variable in raw binary format, using memcpy

Definition at line 469 of file format.hpp.

{
    return from_chars(buf, &r);
}

from_chars() [21/22]

size_t c4::from_chars ( csubstr  buf, fmt::base64_wrapper *  b  )

inline

read a variable in base64 format

Definition at line 134 of file base64.hpp.

{
    return base64_decode(buf, b->data);
}

from_chars() [22/22]

size_t c4::from_chars ( csubstr  buf, fmt::base64_wrapper const &  b  )

inline

read a variable in base64 format

Definition at line 140 of file base64.hpp.

{
    return base64_decode(buf, b.data);
}