fmt_parser.read [method]

fmt_parser.read( int num )

reads at most num bytes from stream and returns them as string

• if 0 bytes are returned, it's quite safe to assume that the function has reached the end of file but check the at_end property to be sure
• may return null and emit a warning on unexpected read errors

stream = fmt_string_parser( "action" );
stream.read( 5 ); // returns "actio"