PushbackReader unread(char[], int, int) in Java

unread(char[], int, int): This method is available in the java.io.PushbackReader class of Java.

Syntax:

void java.io.PushbackReader.unread(char[] cbuf, int off, int len) throws IOException

This method takes three arguments. This method pushes back a portion of an array of characters by copying it to the front of the pushback buffer.

After this method returns, the next character to be read will have the value cbuf[off], the character after that will have the value cbuf[off+1], and so forth.

Parameters: Three parameters are required for this method.

cbuf: Character array.

off: Offset of the first character to push back.

len: Number of characters to push back.

Returns: NA

Throws:

IOException - If there is insufficient room in the pushback buffer, or if some other I/O error occurs

Approach 1: When no exception

Java

import java.io.IOException;
import java.io.PipedReader;
import java.io.PushbackReader;
import java.io.Reader;

public class PushbackReaderunread3 {
    public static void main(String[] args) throws IOException {

        Reader in = new PipedReader();
        int size = 10;
        PushbackReader pushbackReader = new PushbackReader(in, size);

        char cbuf[] = { 'a', 'b', 'c', 'd', 'e' };
        int off = 0, len = 3;
        pushbackReader.unread(cbuf, off, len);

        System.out.println("Successfully unread");

        pushbackReader.close();

    }
}

Output:

Successfully unread

Approach 2: IOException

Java

package com.PushbackReader;

import java.io.IOException;
import java.io.PipedReader;
import java.io.PushbackReader;
import java.io.Reader;

public class PushbackReaderunread3 {
    public static void main(String[] args) throws IOException {

        Reader in = new PipedReader();
        PushbackReader pushbackReader = new PushbackReader(in);

        char cbuf[] = { 'a', 'b', 'c', 'd', 'e' };
        int off = 0, len = 3;
        pushbackReader.unread(cbuf, off, len);

        System.out.println("Successfully unread");

        pushbackReader.close();

    }
}

Output:

Exception in thread "main" java.io.IOException: Pushback buffer overflow
	at java.base/java.io.PushbackReader.unread(PushbackReader.java:179)
	at com.PushbackReader.PushbackReaderunread3.main(PushbackReaderunread3.java:16)

Some other methods of PushbackReader

close(): This method closes the stream and releases any system resources associated with it.

mark(int): This method marks the present position in the stream.

markSupported(): This method tells whether this stream supports the mark() operation, which it does not.

PushbackReader(Reader): This method creates a new pushback reader with a one-character pushback buffer.

PushbackReader(Reader, int): This method creates a new pushback reader with a pushback buffer of the given size.

read(): This method reads a single character.

read(char[], int, int): This method reads characters into a portion of an array.

ready(): This method tells whether this stream is ready to be read.

reset(): This method resets the stream.

skip(long): This method skips characters

unread(char[]): This method pushes back an array of characters by copying it to the front of the pushback buffer.

unread(int): This method pushes back a single character by copying it to the front of the pushback buffer.

unread(char[], int, int):  This method pushes back a portion of an array of characters by copying it to the front of the pushback buffer.