1 // Copyright 2024 The Abseil Authors 2 // 3 // Licensed under the Apache License, Version 2.0 (the "License"); 4 // you may not use this file except in compliance with the License. 5 // You may obtain a copy of the License at 6 // 7 // https://www.apache.org/licenses/LICENSE-2.0 8 // 9 // Unless required by applicable law or agreed to in writing, software 10 // distributed under the License is distributed on an "AS IS" BASIS, 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 // See the License for the specific language governing permissions and 13 // limitations under the License. 14 15 #ifndef ABSL_DEBUGGING_INTERNAL_UTF8_FOR_CODE_POINT_H_ 16 #define ABSL_DEBUGGING_INTERNAL_UTF8_FOR_CODE_POINT_H_ 17 18 #include <cstdint> 19 20 #include "absl/base/config.h" 21 22 namespace absl { 23 ABSL_NAMESPACE_BEGIN 24 namespace debugging_internal { 25 26 struct Utf8ForCodePoint { 27 // Converts a Unicode code point to the corresponding UTF-8 byte sequence. 28 // Async-signal-safe to support use in symbolizing stack traces from a signal 29 // handler. 30 explicit Utf8ForCodePoint(uint64_t code_point); 31 32 // Returns true if the constructor's code_point argument was valid. okUtf8ForCodePoint33 bool ok() const { return length != 0; } 34 35 // If code_point was in range, then 1 <= length <= 4, and the UTF-8 encoding 36 // is found in bytes[0 .. (length - 1)]. If code_point was invalid, then 37 // length == 0. In either case, the contents of bytes[length .. 3] are 38 // unspecified. 39 char bytes[4] = {}; 40 uint32_t length = 0; 41 }; 42 43 } // namespace debugging_internal 44 ABSL_NAMESPACE_END 45 } // namespace absl 46 47 #endif // ABSL_DEBUGGING_INTERNAL_UTF8_FOR_CODE_POINT_H_ 48