Function ffmpeg_sys_next::av_utf8_decode

pub unsafe extern "C" fn av_utf8_decode(
    codep: *mut i32, 
    bufp: *mut *const u8, 
    buf_end: *const u8, 
    flags: c_uint
) -> c_int

Read and decode a single UTF-8 code point (character) from the buffer in *buf, and update *buf to point to the next byte to decode.

In case of an invalid byte sequence, the pointer will be updated to the next byte after the invalid sequence and the function will return an error code.

Depending on the specified flags, the function will also fail in case the decoded code point does not belong to a valid range.

@note For speed-relevant code a carefully implemented use of GET_UTF8() may be preferred.

@param codep pointer used to return the parsed code in case of success. The value in codep is set even in case the range check fails. @param bufp pointer to the address the first byte of the sequence to decode, updated by the function to point to the byte next after the decoded sequence @param buf_end pointer to the end of the buffer, points to the next byte past the last in the buffer. This is used to avoid buffer overreads (in case of an unfinished UTF-8 sequence towards the end of the buffer). @param flags a collection of AV_UTF8_FLAG_ flags @return >= 0 in case a sequence was successfully read, a negative value in case of invalid sequence