> ## Documentation Index
> Fetch the complete documentation index at: https://mehen.ophi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SLOC — Source Lines of Code

> Total physical lines of source code, including comments and blanks.

**SLOC** (Source Lines of Code) is the total count of physical lines in a source file, including code,
comments, and blank lines. It is the simplest possible size metric.

## What mehen emits

| Key        | Type | Description                       |
| ---------- | ---- | --------------------------------- |
| `loc.sloc` | int  | Total physical lines in the file. |
| `loc`      | int  | Alias for `loc.sloc`.             |

## How it is computed

mehen counts physical lines in the source bytes — every newline-terminated region is one line. Files that
do not end with a newline still count the trailing fragment.

## When it is useful

* Repository-level dashboards: total SLOC is a coarse but stable size signal.
* Trend reports: SLOC delta is what most engineering organizations track week over week.
* Sanity checking PR size: if a PR adds 5,000 SLOC, that's worth a comment.

<Warning>
  SLOC is **not** a quality metric. A 50-line file can be more complex than a 500-line one. Use SLOC
  alongside [PLOC](/metrics/code/ploc), [LLOC](/metrics/code/lloc),
  [Cyclomatic complexity](/metrics/code/cyclomatic), and [Cognitive complexity](/metrics/code/cognitive).
</Warning>

## References

* Park, R. E. (1992). *Software Size Measurement: A Framework for Counting Source Statements.*
  CMU/SEI-92-TR-20.
  [SEI report](https://insights.sei.cmu.edu/library/software-size-measurement-a-framework-for-counting-source-statements/).
* Nguyen, V., Deeds-Rubin, S., Tan, T. & Boehm, B. (2007). *A SLOC Counting Standard.* USC.
  [USC PDF](https://csse.usc.edu/TECHRPTS/2007/usc-csse-2007-737/usc-csse-2007-737.pdf).
* Sonar: [`ncloc` in metric definitions](https://docs.sonarsource.com/sonarqube-server/latest/user-guide/code-metrics/metrics-definition/).

## See also

* [LOC family](/metrics/code/loc) — overview of all five LOC variants.
* [PLOC](/metrics/code/ploc) — instruction lines only.
* [LLOC](/metrics/code/lloc) — logical (statement) lines.