# int Settlement::AddUnits(ObjList)

[Family: Settlement](/imperivm/en/CKS/familias/settlement/)

## Exact signature

```text
int Settlement::AddUnits(ObjList)
```

## Description

Attempts nonforced holder entry for eligible members of a supplied ObjList and returns the number of successful entries.

## Parameters and return type

**Return type:** `int`

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

| Position | Type |
| --- | --- |
| 1 | `ObjList` |

## Read and share

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

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