# std::source_location::line

> C++ Atlas: `cppatlas.com/w/cpp/utility/source_location/line` | Source: https://en.cppreference.com/w/cpp/utility/source_location/line | Domain: Utility | Standards: C++20

Returns the line number represented by this object.

## Official Specification Summary (cppreference)

```cpp
constexpr std::uint_least32_t line() const noexcept; // (since C++20)
```

Returns the line number represented by this object.

### Parameters

(none)

### Return value

The line number represented by this object.

An implementation is encouraged to return `0` when the line number is unknown.

### Example

```cpp
#include <iostream>
#include <string_view>
#include <source_location>

inline void cur_line(
    const std::string_view message = "",
    const std::source_location& location = std::source_location::current())
{
    std::cout
        << location.line() // <- the line # of a call site
        << ") "
        << message;
}

int main()
{
    cur_line("++\n");
    cur_line(); std::cout << "Hello,\n";
    cur_line(); std::cout << "C++20!\n";
    cur_line("--\n");
}
```

Output:

```text
17) ++
18) Hello,
19) C++20!
20) --
```

### See also

- [`column`](https://en.cppreference.com/w/cpp/utility/source_location/column): return the column number represented by this object (public member function)
- [`file_name`](https://en.cppreference.com/w/cpp/utility/source_location/file_name): return the file name represented by this object (public member function)
- [`function_name`](https://en.cppreference.com/w/cpp/utility/source_location/function_name): return the name of the function represented by this object, if any (public member function)
- [`source_line`](https://en.cppreference.com/w/cpp/utility/stacktrace_entry/source_line): gets the line number that lexically relates the evaluation represented by the `stacktrace_entry` (public member function of `std::stacktrace_entry`)
- [Filename and line information](https://en.cppreference.com/w/cpp/preprocessor/line)

---
Attribution: content from https://en.cppreference.com/w/cpp/utility/source_location/line (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.