# 内部和大小计数器

## vector\_helper\_get\_count

获取指定 Vector 对象实例中指定类型的计数器值

#### Syntax

```c
size_t vector_helper_get_count
(
    VectorContext* vector_object_context, 
    VectorCountType count_type
);
```

#### Parameters

| 参数名                     | 类型                    | 必选   | 描述                |
| ----------------------- | --------------------- | ---- | ----------------- |
| vector\_object\_context | Vector                | True | 指定 Vector 对象实例描述符 |
| count\_type             | VectorCountType(Enum) | True | 要获取的内部计数器类型       |

#### Return Value

类型：`size_t`

描述：成功返回指定 Vector 对象实例中指定内部计数器的值，失败返回 0。

#### Remarks

该函数的返回值不可靠，因为被获取的内部计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。

## vector\_helper\_get\_size

获取指定 Vector 对象实例中指定类型的大小计数器值

#### Syntax

```
size_t vector_helper_get_size
(
    VectorContext* vector_object_context, 
    VectorSizeType size_type
);
```

#### Parameters

| 参数名                     | 类型                   | 必选   | 描述                |
| ----------------------- | -------------------- | ---- | ----------------- |
| vector\_object\_context | Vector               | True | 指定 Vector 对象实例描述符 |
| size\_type              | VectorSizeType(Enum) | True | 要获取的大小计数器类型       |

#### Return Value

类型：size\_t

描述：成功返回指定 Vector 对象实例中指定大小计数器的值，失败返回 0。

#### Remarks

该函数的返回值不可靠，因为被获取的大小计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。

## vector\_helper\_get\_capacity

获取指定 Vector 对象实例当前可容纳元素的个数

#### Syntax

```
size_t vector_helper_get_capacity
(
    VectorContext * vector_object_context
);
```

#### Parameters

| 参数名                     | 类型     | 必选   | 描述                |
| ----------------------- | ------ | ---- | ----------------- |
| vector\_object\_context | Vector | True | 指定 Vector 对象实例描述符 |

#### Return Value

类型：`size_t`

描述：成功返回指定 Vector 对象实例当前可容纳元素的个数，失败返回 0。

#### Remarks

该函数所返回的当前 Vector 对象实例可容纳元素个数取决于当前内存分配器的运行次数与已分配内存空间的大小（byte）。
