c26445.md

description	title	ms.date	ms.topic	f1_keywords	helpviewer_keywords
Learn more about: C26445 NO_SPAN_REF	C26445	03/22/2018	reference	C26445	C26445

C26445 NO_SPAN_REF

A reference to gsl::span or std::string_view may be an indication of a lifetime issue.

C++ Core Guidelines

GSL.view: Views

This rule catches subtle lifetime issues that may occur in code migrated from standard containers to new span and view types. Such types can be considered as "references to buffers." Using a reference to a span or view creates an additional layer of indirection. Such indirection is often unnecessary and can be confusing for maintainers. Spans are cheap to copy and can be returned by value from function calls. Obviously, such call results should never be referenced.

Remarks

• The rule detects references to gsl::span<>, gsl::basic_string_span<>, and std::basic_string_view<> (including aliases to instantiations).
• Currently warnings are emitted only on declarations and return statements. This rule may be extended in future to also flag function parameters.
• The implementation of this rule is lightweight doesn't attempt to trace actual lifetimes. Using of references may still make sense in some scenarios. In such cases, false positives can safely be suppressed.

Example: Reference to a temporary

// Old API - uses string reference to avoid data copy.
const std::string& get_working_directory() noexcept;

// New API – after migration to C++17 it uses string view.
std::string_view get_working_directory() noexcept;

// ...
// Client code which places an explicit reference in a declaration with auto specifier.
const auto &wd = get_working_directory(); // C26445 after API update.