// Copyright The OpenTelemetry Authors // SPDX-License-Identifier: Apache-2.0 #pragma once #include <cstdint> #include <cstring> #include "opentelemetry/nostd/span.h" #include "opentelemetry/version.h" OPENTELEMETRY_BEGIN_NAMESPACE namespace trace { // TraceId represents an opaque 128-bit trace identifier. The trace identifier // remains constant across the trace. A valid trace identifier is a 16-byte array with at // least one non-zero byte. class TraceId final { public: // The size in bytes of the TraceId. static constexpr int kSize = 16; // An invalid TraceId (all zeros). TraceId() noexcept : rep_{0} {} // Creates a TraceId with the given ID. explicit TraceId(nostd::span<const uint8_t, kSize> id) noexcept { memcpy(rep_, id.data(), kSize); } // Populates the buffer with the lowercase base16 representation of the ID. void ToLowerBase16(nostd::span<char, 2 * kSize> buffer) const noexcept { constexpr char kHex[] = "0123456789abcdef"; for (int i = 0; i < kSize; ++i) { buffer[i * 2 + 0] = kHex[(rep_[i] >> 4) & 0xF]; buffer[i * 2 + 1] = kHex[(rep_[i] >> 0) & 0xF]; } } // Returns a nostd::span of the ID. nostd::span<const uint8_t, kSize> Id() const noexcept { return nostd::span<const uint8_t, kSize>(rep_); } bool operator==(const TraceId &that) const noexcept { return memcmp(rep_, that.rep_, kSize) == 0; } bool operator!=(const TraceId &that) const noexcept { return !(*this == that); } // Returns false if the TraceId is all zeros. bool IsValid() const noexcept { return *this != TraceId(); } // Copies the opaque TraceId data to dest. void CopyBytesTo(nostd::span<uint8_t, kSize> dest) const noexcept { memcpy(dest.data(), rep_, kSize); } private: uint8_t rep_[kSize]; }; } // namespace trace OPENTELEMETRY_END_NAMESPACE

这段代码是OpenTelemetry的C++ SDK中的TraceId类的实现。TraceId是一个128位的追踪标识符，它在整个追踪过程中保持不变。有效的TraceId是一个至少有一个非零字节的16字节数组。

TraceId类提供了以下方法：

- TraceId()构造函数：创建一个无效的TraceId对象，所有字节都为0。
- TraceId(nostd::span<const uint8_t, kSize> id)构造函数：使用给定的ID创建一个TraceId对象。
- ToLowerBase16(nostd::span<char, 2 * kSize> buffer)方法：将TraceId对象转换为小写的base16表示，并将结果存储在buffer中。
- Id()方法：返回一个nostd::span对象，表示TraceId对象的字节。
- IsValid()方法：检查TraceId对象是否有效。
- CopyBytesTo(nostd::span<uint8_t, kSize> dest)方法：将TraceId对象的字节复制到dest中。

TraceId类的实现使用了C++11的特性，如constexpr、noexcept、nostd::span等。它的实现比较简单，主要是对字节数组进行复制、比较、转换等操作。