nodejs
diff --git a/Collapse file
‎doc/api/readline.markdown‎
Copy file name to clipboardExpand all lines: doc/api/readline.markdown
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/readline.markdown‎
Copy file name to clipboardExpand all lines: doc/api/readline.markdown
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff
@@ -232,6 +232,22 @@ line interface:
       process.exit(0);
     });
 
+## Example: Read File Stream Line-by-Line
+
+A common case for `readline`'s `input` option is to pass a filesystem readable
+stream to it. This is how one could craft line-by-line parsing of a file:
+
+    const readline = require('readline');
+    const fs = require('fs');
+
+    const rl = readline.createInterface({
+      input: fs.createReadStream('sample.txt')
+    });
+
+    rl.on('line', function (line) {
+      console.log('Line from file:', line);
+    });
+
 ## readline.clearLine(stream, dir)
 
 Clears current line of given TTY stream in a specified direction.