feat: add BufferReaderExample to demonstrate efficient text reading with BufferedReader

WHAT:
- Implemented `BufferReaderExample` showcasing the use of `BufferedReader` with `FileReader`.
- Demonstrated:
  - Reading characters one by one.
  - Using `mark()` and `reset()` to bookmark and return to a specific position in the stream.
  - Using `readLine()` to read an entire line of text efficiently.
- Closed resources properly after use.

WHY:
- `BufferedReader` provides efficient reading of characters, arrays, and lines compared to raw `FileReader`.
- `mark()` and `reset()` allow controlled navigation inside a stream, useful in parsers or text processors.
- Demonstrates the difference between reading characters vs reading lines.

HOW:
1. Opened a text file using `FileReader`.
2. Wrapped it with `BufferedReader` to enable buffered reading.
3. Read a few characters sequentially.
4. Marked the stream, read ahead, and reset back to the mark.
5. Continued reading, then retrieved the rest of the line using `readLine()`.
6. Closed the reader to release system resources.

REAL-WORLD USE CASES:
- Parsing configuration files or logs line by line.
- Efficiently reading large text files without loading everything into memory.
- Useful in compilers/interpreters where token lookahead requires `mark()` and `reset()`.
- Forms the backbone of text-based file I/O in Java.

NOTES:
- Always pair `mark()` with `reset()`, and ensure `markSupported()` is true before calling.
- Unlike `FileInputStream`, `BufferedReader` is character-based and encoding-aware (good for text files).
- Best practice: use try-with-resources to auto-close streams.

Signed-off-by: https://github.com/Someshdiwan <[email protected]>

Author: Someshdiwan

Section23JavaIOStreams/src/BufferReaderExample.java

@@ -3,10 +3,11 @@
 
 public class BufferReaderExample {
     public static void main(String[] args)throws Exception {
-        // Creating a FileReader to read the file character by character
-        FileReader fis = new FileReader("C://Users//somes//Downloads//JAVA SE//Section23JavaIOStreams//src//MyJAVA//BufferTest.txt");
+        // Creating a FileReader to read the file character by character.
+        FileReader fis = new FileReader("/Users/somesh/Java SE/JavaEvolution-Learning-Growing-Mastering/Section23JavaIOStreams/src/MyJAVA/BufferTest.txt");
+
         BufferedReader bis = new BufferedReader(fis);
-        // BufferedReader is used to read text efficiently from a character-based input stream
+        // BufferedReader is used to read text efficiently from a character-based input stream.
 
         System.out.print(( char ) bis.read());
         System.out.print(( char ) bis.read());
@@ -20,9 +21,9 @@ public static void main(String[] args)throws Exception {
         System.out.print(( char ) bis.read());
         System.out.print(( char ) bis.read());
 
-        // Reading and printing the remaining line from the file
+        // Reading and printing the remaining line from the file.
         System.out.println("String "+bis.readLine());
 
         bis.close();
     }
-}
+}