KSLStringControl

@Target(allowedTargets = [AnnotationTarget.PROPERTY_SETTER])

annotation class KSLStringControl(val allowedValues: Array<String> = [], val name: String = "", val comment: String = "", val include: Boolean = true)(source)

Marks a property setter as a string-valued simulation control.

Parallel to KSLControl for numeric and boolean properties, but targets String properties exclusively. All values are passed and returned as plain String; no numeric coercion occurs.

If allowedValues is non-empty, the ksl.controls.Controls manager enforces membership: any attempt to assign a value outside the set throws a ControlUpdateException. An empty allowedValues array (the default) means the control is unconstrained — any non-null String is accepted.

Usage:

@set:KSLStringControl(
    allowedValues = ["GASOLINE", "DIESEL", "ELECTRIC", "HYBRID"],
    comment = "Fuel type for the vehicle"
)
var fuelType: String = "GASOLINE"