> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Dart Public Setter
A public setter in Dart is a specialized method that provides write access to an object's property. By default, any setter defined without a leading underscore (`_`) is public, meaning it is accessible from anywhere the object's library is imported. Setters are invoked using the assignment operator (`=`) rather than standard method invocation syntax.
Dart implements setters in two ways: implicitly and explicitly.
## Implicit Public Setters
Whenever you declare a mutable, non-final public instance variable, the Dart compiler automatically generates an implicit public setter for it.
```dart theme={"dark"}
class DataModel {
// Generates an implicit public setter: set value(int x)
int value = 0;
}
```
## Explicit Public Setters
An explicit public setter is defined using the `set` keyword. It is typically used to intercept the assignment operation to execute logic before mutating a private backing field.
### Syntax
```dart theme={"dark"}
set propertyName(Type parameterName) {
// Assignment logic
}
```
### Technical Constraints and Characteristics
* **Return Type:** Setters do not return a value. While explicitly declaring a `void` return type (e.g., `void set propertyName(...)`) is valid syntax and will compile, omitting the return type entirely is the recommended Dart style convention and is enforced by the `avoid_return_types_on_setters` lint rule.
* **Parameters:** A setter must accept exactly one required positional parameter. It cannot accept optional, named, or multiple parameters.
* **Naming:** A setter cannot share a name with a method, variable, or getter in the same class, except for its corresponding getter. It is conventionally named after the logical property it mutates, while the actual data is stored in a private backing variable (prefixed with `_`).
* **Invocation:** Setters are called via property access syntax, not method syntax.
### Implementation Example
```dart theme={"dark"}
class Measurement {
// Private backing field
double _magnitude = 0.0;
// Explicit public setter
set magnitude(double value) {
_magnitude = value;
}
}
void main() {
var measure = Measurement();
// Invokes the public setter using the assignment operator
measure.magnitude = 42.5;
// INVALID: measure.magnitude(42.5);
}
```
## Arrow Syntax
For setters containing a single expression, Dart supports the concise arrow (`=>`) syntax.
```dart theme={"dark"}
class Measurement {
double _magnitude = 0.0;
// Public setter using arrow syntax
set magnitude(double value) => _magnitude = value;
}
```
Tired of Poor Dart Skills? Fix That With Deep Grasping!
Learn More
