aboutsummaryrefslogtreecommitdiffhomepage
path: root/Firestore/core/src/firebase/firestore/util/log.h
blob: 248d434ac4e741c310c118c47c9f15be8e9381d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
/*
 * Copyright 2017 Google
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef FIRESTORE_CORE_SRC_FIREBASE_FIRESTORE_UTIL_LOG_H_
#define FIRESTORE_CORE_SRC_FIREBASE_FIRESTORE_UTIL_LOG_H_

#include <string>

#include "Firestore/core/src/firebase/firestore/util/string_format.h"

namespace firebase {
namespace firestore {
namespace util {

// Levels used when logging messages.
enum LogLevel {
  // Debug Log Level
  kLogLevelDebug,
  // Warning Log Level
  kLogLevelWarning,
};

// Log a message if kLogLevelDebug is enabled. Arguments are not evaluated if
// logging is disabled.
//
// @param format A format string suitable for use with `util::StringFormat`
// @param ... C++ variadic arguments that match the format string. Not C
//     varargs.
#define LOG_DEBUG(...)                                         \
  do {                                                         \
    namespace _util = firebase::firestore::util;               \
    if (_util::LogIsLoggable(_util::kLogLevelDebug)) {         \
      std::string _message = _util::StringFormat(__VA_ARGS__); \
      _util::LogMessage(_util::kLogLevelDebug, _message);      \
    }                                                          \
  } while (0)

// Log a message if kLogLevelWarn is enabled (it is by default). Arguments are
// not evaluated if logging is disabled.
//
// @param format A format string suitable for use with `util::StringFormat`
// @param ... C++ variadic arguments that match the format string. Not C
//     varargs.
#define LOG_WARN(...)                                          \
  do {                                                         \
    namespace _util = firebase::firestore::util;               \
    if (_util::LogIsLoggable(_util::kLogLevelWarning)) {       \
      std::string _message = _util::StringFormat(__VA_ARGS__); \
      _util::LogMessage(_util::kLogLevelWarning, _message);    \
    }                                                          \
  } while (0)

// Tests to see if the given log level is loggable.
bool LogIsLoggable(LogLevel level);

// Is debug logging enabled?
inline bool LogIsDebugEnabled() {
  return LogIsLoggable(kLogLevelDebug);
}

// All messages at or above the specified log level value are displayed.
void LogSetLevel(LogLevel level);

// Log a message at the given level.
void LogMessage(LogLevel log_level, const std::string& message);

}  // namespace util
}  // namespace firestore
}  // namespace firebase

#endif  // FIRESTORE_CORE_SRC_FIREBASE_FIRESTORE_UTIL_LOG_H_