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...

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/21]

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

inlinenoexcept

Definition at line 2366 of file charconv.hpp.

{ return atou(buf, v); }

References c4::atou().

from_chars() [2/21]

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

inlinenoexcept

Definition at line 2367 of file charconv.hpp.

{ return atou(buf, v); }

References c4::atou().

from_chars() [3/21]

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

inlinenoexcept

Definition at line 2368 of file charconv.hpp.

{ return atou(buf, v); }

References c4::atou().

from_chars() [4/21]

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

inlinenoexcept

Definition at line 2369 of file charconv.hpp.

{ return atou(buf, v); }

References c4::atou().

from_chars() [5/21]

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

inlinenoexcept

Definition at line 2370 of file charconv.hpp.

{ return atoi(buf, v); }

References c4::atoi().

from_chars() [6/21]

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

inlinenoexcept

Definition at line 2371 of file charconv.hpp.

{ return atoi(buf, v); }

References c4::atoi().

from_chars() [7/21]

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

inlinenoexcept

Definition at line 2372 of file charconv.hpp.

{ return atoi(buf, v); }

References c4::atoi().

from_chars() [8/21]

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

inlinenoexcept

Definition at line 2373 of file charconv.hpp.

{ return atoi(buf, v); }

References c4::atoi().

from_chars() [9/21]

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

inlinenoexcept

Definition at line 2374 of file charconv.hpp.

{ return atof(buf, v); }

References c4::atof().

from_chars() [10/21]

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

inlinenoexcept

Definition at line 2375 of file charconv.hpp.

{ return atod(buf, v); }

References c4::atod().

from_chars() [11/21]

template<class T >

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

inlinenoexcept

Definition at line 2377 of file charconv.hpp.

{ return atoi(buf, v); }

from_chars() [12/21]

template<class T >

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

inlinenoexcept

Definition at line 2380 of file charconv.hpp.

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

References c4::from_chars().

from_chars() [13/21]

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

inlinenoexcept

Definition at line 2449 of file charconv.hpp.

{
    if(buf == '0')
    {
        *v = false; return true;
    }
    else if(buf == '1')
    {
        *v = true; return true;
    }
    else if(buf == "false")
    {
        *v = false; return true;
    }
    else if(buf == "true")
    {
        *v = true; return true;
    }
    else if(buf == "False")
    {
        *v = false; return true;
    }
    else if(buf == "True")
    {
        *v = true; return true;
    }
    else if(buf == "FALSE")
    {
        *v = false; return true;
    }
    else if(buf == "TRUE")
    {
        *v = true; 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;
}

References c4::from_chars().

from_chars() [14/21]

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 2521 of file charconv.hpp.

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

from_chars() [15/21]

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

inlinenoexcept

Definition at line 2561 of file charconv.hpp.

{
    *v = buf;
    return true;
}

from_chars() [16/21]

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

inlinenoexcept

Definition at line 2599 of file charconv.hpp.

{
    C4_ASSERT(!buf.overlaps(*v));
    // is the destination buffer wide enough?
    if(v->len >= buf.len)
    {
        // calling memcpy with null strings 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/21]

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 330 of file format.hpp.

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

References c4::atox(), and c4::fmt::overflow_checked_< T >::val.

from_chars() [18/21]

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 339 of file format.hpp.

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

References c4::atox(), and c4::fmt::overflow_checked_< T >::val.

from_chars() [19/21]

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

read a variable in raw binary format, using memcpy

from_chars() [20/21]

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

inline

read a variable in raw binary format, using memcpy

Definition at line 473 of file format.hpp.

{
    return from_chars(buf, &r);
}

References c4::from_chars().

from_chars() [21/21]

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);
}

References c4::base64_decode(), and c4::fmt::base64_wrapper_< CharOrConstChar >::data.