base/internal/strerror.h

0001 // Copyright 2020 The Abseil Authors.
0002 //
0003 // Licensed under the Apache License, Version 2.0 (the "License");
0004 // you may not use this file except in compliance with the License.
0005 // You may obtain a copy of the License at
0006 //
0007 //      https://www.apache.org/licenses/LICENSE-2.0
0008 //
0009 // Unless required by applicable law or agreed to in writing, software
0010 // distributed under the License is distributed on an "AS IS" BASIS,
0011 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0012 // See the License for the specific language governing permissions and
0013 // limitations under the License.
0014
0015 #ifndef ABSL_BASE_INTERNAL_STRERROR_H_
0016 #define ABSL_BASE_INTERNAL_STRERROR_H_
0017
0018 #include <string>
0019
0020 #include "absl/base/config.h"
0021
0022 namespace absl {
0023 ABSL_NAMESPACE_BEGIN
0024 namespace base_internal {
0025
0026 // A portable and thread-safe alternative to C89's `strerror`.
0027 //
0028 // The C89 specification of `strerror` is not suitable for use in a
0029 // multi-threaded application as the returned string may be changed by calls to
0030 // `strerror` from another thread.  The many non-stdlib alternatives differ
0031 // enough in their names, availability, and semantics to justify this wrapper
0032 // around them.  `errno` will not be modified by a call to `absl::StrError`.
0033 std::string StrError(int errnum);
0034
0035 }  // namespace base_internal
0036 ABSL_NAMESPACE_END
0037 }  // namespace absl
0038
0039 #endif  // ABSL_BASE_INTERNAL_STRERROR_H_