blob: 987730f226eae7b94c891aa0cba835b4562d5854 [file] [log] [blame]
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_VLOG_H_
#define BASE_VLOG_H_
#include <cstddef>
#include <string>
#include <vector>
#include "base/base_export.h"
#include "base/basictypes.h"
#include "base/string_piece.h"
namespace logging {
// A helper class containing all the settings for vlogging.
class BASE_EXPORT VlogInfo {
public:
static const int kDefaultVlogLevel;
// |v_switch| gives the default maximal active V-logging level; 0 is
// the default. Normally positive values are used for V-logging
// levels.
//
// |vmodule_switch| gives the per-module maximal V-logging levels to
// override the value given by |v_switch|.
// E.g. "my_module=2,foo*=3" would change the logging level for all
// code in source files "my_module.*" and "foo*.*" ("-inl" suffixes
// are also disregarded for this matching).
//
// |log_severity| points to an int that stores the log level. If a valid
// |v_switch| is provided, it will set the log level, and the default
// vlog severity will be read from there..
//
// Any pattern containing a forward or backward slash will be tested
// against the whole pathname and not just the module. E.g.,
// "*/foo/bar/*=2" would change the logging level for all code in
// source files under a "foo/bar" directory.
VlogInfo(const std::string& v_switch,
const std::string& vmodule_switch,
int* min_log_level);
~VlogInfo();
// Returns the vlog level for a given file (usually taken from
// __FILE__).
int GetVlogLevel(const base::StringPiece& file) const;
private:
void SetMaxVlogLevel(int level);
int GetMaxVlogLevel() const;
// VmodulePattern holds all the information for each pattern parsed
// from |vmodule_switch|.
struct VmodulePattern;
std::vector<VmodulePattern> vmodule_levels_;
int* min_log_level_;
DISALLOW_COPY_AND_ASSIGN(VlogInfo);
};
// Returns true if the string passed in matches the vlog pattern. The
// vlog pattern string can contain wildcards like * and ?. ? matches
// exactly one character while * matches 0 or more characters. Also,
// as a special case, a / or \ character matches either / or \.
//
// Examples:
// "kh?n" matches "khan" but not "khn" or "khaan"
// "kh*n" matches "khn", "khan", or even "khaaaaan"
// "/foo\bar" matches "/foo/bar", "\foo\bar", or "/foo\bar"
// (disregarding C escaping rules)
BASE_EXPORT bool MatchVlogPattern(const base::StringPiece& string,
const base::StringPiece& vlog_pattern);
} // namespace logging
#endif // BASE_VLOG_H_