Cognitive complexity
Cognitive complexity is the mental effort required to understand code or a system, particularly as nesting, control-flow breaks, or investigative paths increase.
The Art of Code
Cognitive complexity is a code-complexity metric that estimates the mental effort required to understand control flow, especially when flow-breaking structures and nesting are present.
- How it is used
- Identifies control-flow hotspots that undermine simplicity and readability, guiding targeted refactoring.
- How deep it goes
- Explains flow-breaking structures, nesting, Boolean conditions, per-method scoring, and refactoring strategies; defers functional-programming detail.
- Examples
- Uses email-reminder refactorings, stream pipelines, a SonarQube code smell, and a Kotlin promotional-message if/else chain.
- What you can do after
- Apply it via SonarQube or manual review to locate nested, flow-breaking methods and choose clearer refactorings.
Troubleshooting Java, Second Edition
The mental difficulty of understanding code investigation as the number of nested reasoning paths and open investigative plans increases.
- How it is used
- Guides code investigation when visible logic is insufficient to explain runtime behavior.
- How deep it goes
- Explains nested reasoning plans and investigation trade-offs, but stops short of formal measurement or debugging metrics.
- Examples
- Uses a Java Decoder method, StringDigitExtractor calls, and questions about returned digits and changed state.
- What you can do after
- Diagnose/debug with it by controlling investigation depth and tracing hidden behavior behind method calls.
Read how Troubleshooting Java, Second Edition explains cognitive complexity →
Related concepts
- functional, stateless philosophyaddressed by · Functional programming is a programming paradigm that expresses computation through the evaluation and composition of functions, typically favoring immutable data and minimizing mutable state and side effects.
- expressive powercontrasts with · Expressive power is the capacity of a model, language, or system to represent or convey a range and complexity of functions, patterns, distinctions, or ideas.
- cyclomatic complexityalternative to · Cyclomatic complexity is a software metric that measures the number of linearly independent execution paths through a program's control-flow graph.
- flow-breaking structuremeasures · A flow-breaking structure is a control-flow construct that interrupts straightforward sequential execution and requires reasoning about alternate execution paths.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.