Implementing: java.lang.Readable

Attempts to read characters into the specified character buffer. The buffer is used as a repository of characters as-is: the only changes made are the results of a put operation. No flipping or rewinding of the buffer is performed.

Parameters:

target

the buffer to read characters into

Returns:  The number of characters added to the buffer, or -1 if this source of characters is at its end

Exceptions:

IOException

if an I/O error occurs

Since:  1.5