
 
        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.
        
        
Returns:
    The number of characters added to the buffer, or 
         -1 if this source of characters is at its end 
Parameters:
 - 
target - the buffer to read characters into
Throws:
  - 
IOException - if an I/O error occurs
  - 
NullPointerException - if target is null
  - 
ReadOnlyBufferException - if target is a read only buffer
Since:
    1.5