# void Hero::SetFormation(str)

[Family: Hero](/imperivm/en/CKS/familias/hero/)

## Exact signature

```text
void Hero::SetFormation(str)
```

## Description

SetFormation resolves the supplied string in the formation map and, when found and Hero [field] exists, passes the string text to the formation object shape-setting helper; unknown names and invalid Heroes call the error helper.

## Parameters and return type

**Return type:** `void`

The member is called on an object. Its receiver is not repeated among this signature’s arguments.

| Position | Type |
| --- | --- |
| 1 | `str` |

## Read and share

- [Markdown](/imperivm/exports/en/cks/api-141cf26b2b1303.md)
- [JSON](/imperivm/CKS/api/entries/api-141cf26b2b1303?lang=en)

Keep the notes and limitations when reusing this description. Do not infer undocumented parameter meanings, units or effects.