==============================================================================

attempt to pull a buffer from the ring buffer from the current "out" index

attempt to push a buffer into the ring buffer at the current "in" index

Returns the number of elements. The length() and size() methods are equivalent.

==============================================================================

* Update context to reflect the concatenation of another buffer full * of bytes. */

this is by far the most heavily used reader call. it ain't pretty but it's fast */

on return, if *val == 0xffffffff then the utf-8 sequence was invalid, but the return value will be true */

on return, if *val == 0xffffffffffffffff then the utf-8 sequence was invalid, but the return value will be true */

Will never be emitted for MSVC, GCC, Intel compilers */

4-term -92dB side-lobe */