function converts a string of wide characters indirectly pointed to by
to a corresponding multibyte character string stored in the array
pointed to by
No more than
bytes are written to
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
characters from the buffer pointed to by