xref: /aosp_15_r20/external/sandboxed-api/sandboxed_api/util/strerror.h (revision ec63e07ab9515d95e79c211197c445ef84cefa6a)
1*ec63e07aSXin Li // Copyright 2019 Google LLC
2*ec63e07aSXin Li //
3*ec63e07aSXin Li // Licensed under the Apache License, Version 2.0 (the "License");
4*ec63e07aSXin Li // you may not use this file except in compliance with the License.
5*ec63e07aSXin Li // You may obtain a copy of the License at
6*ec63e07aSXin Li //
7*ec63e07aSXin Li //     https://www.apache.org/licenses/LICENSE-2.0
8*ec63e07aSXin Li //
9*ec63e07aSXin Li // Unless required by applicable law or agreed to in writing, software
10*ec63e07aSXin Li // distributed under the License is distributed on an "AS IS" BASIS,
11*ec63e07aSXin Li // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12*ec63e07aSXin Li // See the License for the specific language governing permissions and
13*ec63e07aSXin Li // limitations under the License.
14*ec63e07aSXin Li 
15*ec63e07aSXin Li #ifndef SANDBOXED_API_UTIL_STRERROR_H_
16*ec63e07aSXin Li #define SANDBOXED_API_UTIL_STRERROR_H_
17*ec63e07aSXin Li 
18*ec63e07aSXin Li #include <cstddef>
19*ec63e07aSXin Li #include <string>
20*ec63e07aSXin Li 
21*ec63e07aSXin Li namespace sapi {
22*ec63e07aSXin Li 
23*ec63e07aSXin Li // Returns a human-readable string describing the given POSIX error code. This
24*ec63e07aSXin Li // is a portable and thread-safe alternative to strerror(). If the error code is
25*ec63e07aSXin Li // not translatable, the string will be "Unknown error nnn". errno will not be
26*ec63e07aSXin Li // modified by this call. This function is thread-safe.
27*ec63e07aSXin Li std::string StrError(int errnum);
28*ec63e07aSXin Li 
29*ec63e07aSXin Li // Same as StrError but uses provided buffer (does not allocate memory).
30*ec63e07aSXin Li // Might use and return a static immutable buffer instead of buf.
31*ec63e07aSXin Li const char* RawStrError(int errnum, char* buf, size_t buflen);
32*ec63e07aSXin Li 
33*ec63e07aSXin Li }  // namespace sapi
34*ec63e07aSXin Li 
35*ec63e07aSXin Li #endif  // SANDBOXED_API_STRERROR_H_
36