function converts a sequence of multibyte characters pointed to indirectly by
into a sequence of corresponding wide characters and stores at most
of them in the
array pointed to by
until it encounters a terminating null character
no characters are stored.
the pointer pointed to by
is updated to point to the character after the one that conversion stopped at.
If conversion stops because a null character is encountered,
is set to
is used to keep track of the shift state.
If it is
uses an internal, static
object, which is initialized to the initial conversion state
at program startup.
function behaves identically to
except that conversion stops after reading at most
bytes from the buffer pointed to by