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

# tostring

> Convert a value to a string.

`tostring(v)` converts `v` to a string. Numbers and booleans are formatted in their natural text representation. Strings pass through unchanged.

## Signature

```
tostring(v any) string
```

## Example

Convert a numeric port variable to a string to use it as a map key or pass it to functions that require strings:

```hcl theme={null}
variable "replicas" {
  description = "Number of deployment replicas"
  type        = number
  default     = 2
}

computed "replica_label" {
  description = "Replica count as a Kubernetes label value"
  expression  = tostring(var.replicas)
}

task "deploy" {
  description = "Deploy with the replica count label"
  commands = [
    "kubectl apply -f k8s/",
    "kubectl label deployment/app replica-count=${computed.replica_label} --overwrite",
  ]
}
```

`2` becomes `"2"`, which is a valid Kubernetes label value.

## Notes

* `tostring` is most useful when a typed value (number, bool) needs to be used in a context that requires a string, such as a function argument, label value, or map key.
* In command strings, string interpolation already converts values automatically. `tostring` is needed explicitly only in expression contexts.