// Copyright (c) 2018 Emil Dotchevski // Copyright (c) 2018 Second Spectrum, Inc. // Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // This is a short but complete program that reads a text file in a buffer and prints it to std::cout, // using LEAF to handle errors. It uses exception handling. #include #include #include #include #include #include namespace leaf = boost::leaf; // Exception type hierarchy. struct print_file_error : virtual std::exception { }; struct command_line_error : virtual print_file_error { }; struct bad_command_line : virtual command_line_error { }; struct input_error : virtual print_file_error { }; struct input_file_error : virtual input_error { }; struct input_file_open_error : virtual input_file_error { }; struct input_file_size_error : virtual input_file_error { }; struct input_file_read_error : virtual input_file_error { }; struct input_eof_error : virtual input_file_error { }; // We will handle all failures in our main function, but first, here are the declarations of the functions it calls, each // communicating failures by throwing exceptions // Parse the command line, return the file name. char const * parse_command_line( int argc, char const * argv[ ] ); // Open a file for reading. std::shared_ptr file_open( char const * file_name ); // Return the size of the file. int file_size( FILE & f ); // Read size bytes from f into buf. void file_read( FILE & f, void * buf, int size ); int main( int argc, char const * argv[ ] ) { // Configure std::cout to throw on error. std::cout.exceptions(std::ostream::failbit | std::ostream::badbit); return leaf::try_( [&] { char const * file_name = parse_command_line(argc,argv); auto propagate = leaf::preload( leaf::e_file_name{file_name} ); std::shared_ptr f = file_open( file_name ); int s = file_size(*f); std::string buffer( 1 + s, '\0' ); file_read(*f,&buffer[0],buffer.size()-1); auto propagate2 = leaf::defer([ ] { return leaf::e_errno{errno}; } ); std::cout << buffer; std::cout.flush(); return 0; }, // Each of the lambdas below is an error handler. LEAF will consider them, in order, and call the first one that matches // the available error information. // This handler will be called if the error includes: // - a caught exception of type input_file_open_error, and // - an object of type leaf::e_errno that has .value equal to ENOENT, and // - an object of type leaf::e_file_name. [ ]( leaf::catch_, leaf::match, leaf::e_file_name const & fn ) { std::cerr << "File not found: " << fn.value << std::endl; return 1; }, // This handler will be called if the error includes: // - a caught exception of type input_file_open_error, and // - an object of type leaf::e_errno (regardless of its .value), and // - an object of type leaf::e_file_name. [ ]( leaf::catch_, leaf::e_errno const & errn, leaf::e_file_name const & fn ) { std::cerr << "Failed to open " << fn.value << ", errno=" << errn << std::endl; return 2; }, // This handler will be called if the error includes: // - a caught exception of type input_error, and // - an object of type leaf::e_errno (regardless of its .value), and // - an object of type leaf::e_file_name. [ ]( leaf::catch_, leaf::e_errno const & errn, leaf::e_file_name const & fn ) { std::cerr << "Failed to access " << fn.value << ", errno=" << errn << std::endl; return 3; }, // This handler will be called if the error includes: // - a caught exception of type std::ostream::failure, and // - an object of type leaf::e_errno (regardless of its .value), [ ]( leaf::catch_, leaf::e_errno const & errn ) { std::cerr << "Output error, errno=" << errn << std::endl; return 4; }, // This handler will be called if the error includes a caught exception of type bad_command_line. [ ]( leaf::catch_ ) { std::cout << "Bad command line argument" << std::endl; return 5; }, // This last handler matches any error: it prints diagnostic information to help debug logic errors in the program, since it // failed to match an appropriate error handler to the error condition it encountered. In this program this handler will // never be called. [ ]( leaf::error_info const & unmatched ) { std::cerr << "Unknown failure detected" << std::endl << "Cryptic diagnostic information follows" << std::endl << unmatched; return 6; } ); } // Implementations of the functions called by main: // Parse the command line, return the file name. char const * parse_command_line( int argc, char const * argv[ ] ) { if( argc==2 ) return argv[1]; else throw leaf::exception(bad_command_line()); } // Open a file for reading. std::shared_ptr file_open( char const * file_name ) { if( FILE * f = fopen(file_name,"rb") ) return std::shared_ptr(f,&fclose); else throw leaf::exception(input_file_open_error(), leaf::e_errno{errno}); } // Return the size of the file. int file_size( FILE & f ) { // All exceptions escaping this function will automatically propagate errno. auto propagate = leaf::defer( [ ] { return leaf::e_errno{errno}; } ); if( fseek(&f,0,SEEK_END) ) throw leaf::exception(input_file_size_error()); int s = ftell(&f); if( s==-1L ) throw leaf::exception(input_file_size_error()); if( fseek(&f,0,SEEK_SET) ) throw leaf::exception(input_file_size_error()); return s; } // Read size bytes from f into buf. void file_read( FILE & f, void * buf, int size ) { int n = fread(buf,1,size,&f); if( ferror(&f) ) throw leaf::exception( input_file_read_error(), leaf::e_errno{errno} ); if( n!=size ) throw leaf::exception(input_eof_error()); }