aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/restricted/abseil-cpp/absl/flags/usage.cc
blob: e47c26f1aa89377aa70a408749c00bab654ebc20 (plain) (blame)
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
// 
// Copyright 2019 The Abseil Authors. 
// 
// 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 
// 
//      https://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. 
#include "absl/flags/usage.h" 
 
#include <stdlib.h>

#include <string> 
 
#include "absl/base/attributes.h"
#include "absl/base/config.h"
#include "absl/base/const_init.h"
#include "absl/base/thread_annotations.h"
#include "absl/flags/internal/usage.h" 
#include "absl/strings/string_view.h"
#include "absl/synchronization/mutex.h" 
 
namespace absl { 
ABSL_NAMESPACE_BEGIN
namespace flags_internal { 
namespace { 
ABSL_CONST_INIT absl::Mutex usage_message_guard(absl::kConstInit); 
ABSL_CONST_INIT std::string* program_usage_message 
    ABSL_GUARDED_BY(usage_message_guard) = nullptr; 
}  // namespace 
}  // namespace flags_internal 
 
// -------------------------------------------------------------------- 
// Sets the "usage" message to be used by help reporting routines. 
void SetProgramUsageMessage(absl::string_view new_usage_message) { 
  absl::MutexLock l(&flags_internal::usage_message_guard); 
 
  if (flags_internal::program_usage_message != nullptr) { 
    ABSL_INTERNAL_LOG(FATAL, "SetProgramUsageMessage() called twice."); 
    std::exit(1); 
  } 
 
  flags_internal::program_usage_message = new std::string(new_usage_message); 
} 
 
// -------------------------------------------------------------------- 
// Returns the usage message set by SetProgramUsageMessage(). 
// Note: We able to return string_view here only because calling 
// SetProgramUsageMessage twice is prohibited. 
absl::string_view ProgramUsageMessage() { 
  absl::MutexLock l(&flags_internal::usage_message_guard); 
 
  return flags_internal::program_usage_message != nullptr 
             ? absl::string_view(*flags_internal::program_usage_message) 
             : "Warning: SetProgramUsageMessage() never called"; 
} 
 
ABSL_NAMESPACE_END
}  // namespace absl