// Copyright 2023 The Chromium Authors

// Use of this source code is governed by a BSD-style license that can be

// found in the LICENSE file.

#ifndef BASE_MEMORY_RAW_SPAN_H_

#define BASE_MEMORY_RAW_SPAN_H_

#include "base/containers/span.h"

#include "base/memory/raw_ptr.h"

namespace base {

// raw_span<T> is a type that provides the spatial safety of span<T> along

// with the temporal safety of raw_ptr<T>. This is intended to be a safer

// replacement for classes that store pointer size fields. As is the case

// with raw_ptr<>, raw_span<> should be used for class members only, with

// ordinary span<> used for function arguments and the like. Note that

// raw_span<> will implicitly convert to span<> for ease of use in these

// cases.

template <typename T, RawPtrTraits Traits = RawPtrTraits::kEmpty>

using raw_span =

span<T, dynamic_extent, raw_ptr<T, Traits | AllowPtrArithmetic>>;

template <typename T>

span<T> ExtractAsDanglingSpan(raw_span<T>& arg) {

span<T> result = std::exchange(arg, raw_span<T>());

return result;

}

} // namespace base

#endif // BASE_MEMORY_RAW_SPAN_H_