PBRT
|
00001 00002 // 00003 // Copyright (c) 2002, Industrial Light & Magic, a division of Lucas 00004 // Digital Ltd. LLC 00005 // 00006 // All rights reserved. 00007 // 00008 // Redistribution and use in source and binary forms, with or without 00009 // modification, are permitted provided that the following conditions are 00010 // met: 00011 // * Redistributions of source code must retain the above copyright 00012 // notice, this list of conditions and the following disclaimer. 00013 // * Redistributions in binary form must reproduce the above 00014 // copyright notice, this list of conditions and the following disclaimer 00015 // in the documentation and/or other materials provided with the 00016 // distribution. 00017 // * Neither the name of Industrial Light & Magic nor the names of 00018 // its contributors may be used to endorse or promote products derived 00019 // from this software without specific prior written permission. 00020 // 00021 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00022 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00023 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00024 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 00025 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00026 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00027 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 00028 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 00029 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 00030 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00031 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00032 // 00034 00035 00036 00037 #ifndef INCLUDED_IEXTHROWERRNOEXC_H 00038 #define INCLUDED_IEXTHROWERRNOEXC_H 00039 00040 //---------------------------------------------------------- 00041 // 00042 // A function which throws ExcErrno exceptions 00043 // 00044 //---------------------------------------------------------- 00045 00046 #include "IexBaseExc.h" 00047 00048 namespace Iex { 00049 00050 00051 //-------------------------------------------------------------------------- 00052 // 00053 // Function throwErrnoExc() throws an exception which corresponds to 00054 // error code errnum. The exception text is initialized with a copy 00055 // of the string passed to throwErrnoExc(), where all occurrences of 00056 // "%T" have been replaced with the output of strerror(oserror()). 00057 // 00058 // Example: 00059 // 00060 // If opening file /tmp/output failed with an ENOENT error code, 00061 // calling 00062 // 00063 // throwErrnoExc (); 00064 // 00065 // or 00066 // 00067 // throwErrnoExc ("%T."); 00068 // 00069 // will throw an EnoentExc whose text reads 00070 // 00071 // No such file or directory. 00072 // 00073 // More detailed messages can be assembled using stringstreams: 00074 // 00075 // std::stringstream s; 00076 // s << "Cannot open file " << name << " (%T)."; 00077 // throwErrnoExc (s); 00078 // 00079 // The resulting exception contains the following text: 00080 // 00081 // Cannot open file /tmp/output (No such file or directory). 00082 // 00083 // Alternatively, you may want to use the THROW_ERRNO macro defined 00084 // in IexMacros.h: 00085 // 00086 // THROW_ERRNO ("Cannot open file " << name << " (%T).") 00087 // 00088 //-------------------------------------------------------------------------- 00089 00090 void throwErrnoExc (const std::string &txt, int errnum); 00091 void throwErrnoExc (const std::string &txt = "%T." /*, int errnum = oserror() */); 00092 00093 00094 } // namespace Iex 00095 00096 #endif