# int EvalGroup(str)

[Family: Global](/en/CKS/familias/global/)

## Exact signature

```text
int EvalGroup(str)
```

## Description

Adds up the evaluation of the live units in the group named by the text. Returns 0 if the group does not exist, without creating it.

## Usage notes

Only objects still on the map count. The meaning of the evaluation value is not documented here.

## Parameters and return type

**Return type:** `int`

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

## Read and share

- [Markdown](/exports/en/cks/api-44de89c848b0f2.md)
- [JSON](/CKS/api/entries/api-44de89c848b0f2?lang=en)

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