1 /* 2 * libjingle 3 * Copyright 2015 Google Inc. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #import <Foundation/Foundation.h> 29 30 // Subset of rtc::LoggingSeverity. 31 typedef NS_ENUM(NSInteger, RTCLoggingSeverity) { 32 kRTCLoggingSeverityVerbose, 33 kRTCLoggingSeverityInfo, 34 kRTCLoggingSeverityWarning, 35 kRTCLoggingSeverityError, 36 }; 37 38 #if defined(__cplusplus) 39 extern "C" void RTCLogEx(RTCLoggingSeverity severity, NSString* logString); 40 extern "C" void RTCSetMinDebugLogLevel(RTCLoggingSeverity severity); 41 extern "C" NSString* RTCFileName(const char* filePath); 42 #else 43 44 // Wrapper for C++ LOG(sev) macros. 45 // Logs the log string to the webrtc logstream for the given severity. 46 extern void RTCLogEx(RTCLoggingSeverity severity, NSString* logString); 47 48 // Wrapper for rtc::LogMessage::LogToDebug. 49 // Sets the minimum severity to be logged to console. 50 extern void RTCSetMinDebugLogLevel(RTCLoggingSeverity severity); 51 52 // Returns the filename with the path prefix removed. 53 extern NSString* RTCFileName(const char* filePath); 54 55 #endif 56 57 // Some convenience macros. 58 59 #define RTCLogString(format, ...) \ 60 [NSString stringWithFormat:@"(%@:%d %s): " format, \ 61 RTCFileName(__FILE__), \ 62 __LINE__, \ 63 __FUNCTION__, \ 64 ##__VA_ARGS__] 65 66 #define RTCLogFormat(severity, format, ...) \ 67 do { \ 68 NSString *logString = RTCLogString(format, ##__VA_ARGS__); \ 69 RTCLogEx(severity, logString); \ 70 } while (false) 71 72 #define RTCLogVerbose(format, ...) \ 73 RTCLogFormat(kRTCLoggingSeverityVerbose, format, ##__VA_ARGS__) \ 74 75 #define RTCLogInfo(format, ...) \ 76 RTCLogFormat(kRTCLoggingSeverityInfo, format, ##__VA_ARGS__) \ 77 78 #define RTCLogWarning(format, ...) \ 79 RTCLogFormat(kRTCLoggingSeverityWarning, format, ##__VA_ARGS__) \ 80 81 #define RTCLogError(format, ...) \ 82 RTCLogFormat(kRTCLoggingSeverityError, format, ##__VA_ARGS__) \ 83 84 #if !defined(NDEBUG) 85 #define RTCLogDebug(format, ...) RTCLogInfo(format, ##__VA_ARGS__) 86 #else 87 #define RTCLogDebug(format, ...) \ 88 do { \ 89 } while (false) 90 #endif 91 92 #define RTCLog(format, ...) RTCLogInfo(format, ##__VA_ARGS__) 93