# CContainerKit

**Repository Path**: CatIsNotFound/ccontainer-kit

## Basic Information

- **Project Name**: CContainerKit
- **Description**: 基于 C11 标准的 C 语言容器集合。
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://catisnotfound.github.io/CContainerKit-Wiki/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-14
- **Last Updated**: 2025-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[简体中文](assets/README_zh.md)

# CContainerKit

A collection of extended C container libraries based on the C11 standard, including common data structures such as static arrays, dynamic arrays, stacks, queues, dynamic linked lists, and general binary trees. Suitable for beginners learning C/C++.

This library is a personal project for learning data structures and may have problems and shortcomings.

The author welcomes you to ask questions or provide suggestions in [Discussions](https://github.com/CatIsNotFound/CContainerKit/discussions) or [Issues](https://github.com/CatIsNotFound/CContainerKit/issues) to help improve this project.

> Note:
> 
> For users viewing this repository on Gitee, you can go to [Issues](https://gitee.com/CatIsNotFound/ccontainer-kit/issues) to ask questions or provide suggestions.

## Features

- C extension library with C11 support.
- Various container implementations are provided, such as static arrays, dynamic arrays, stacks, queues, etc.
- Support storage and manipulation of variables of any type.

## Quick Start

Visit the [Quick Start page](https://catisnotfound.github.io/CContainerKit-Wiki/quickstart) to get started with this library quickly.

## API Reference

Visit the [APIs page](https://catisnotfound.github.io/CContainerKit-Wiki/apis/) to view all supported APIs.

## Current Progress

| Container Name | Completion Progress | Description                  |
|----------------|---------------------|------------------------------|
| CArray         | 85%                 | Static array                 |
| CVector        | 90%                 | Dynamic array                |
| CString        | 85%                 | String                       |
| CStack         | 75%                 | Stack (Based on CVector)     |
| CDeque         | 75%                 | Queue (Based on CVector)     |
| CLinkedList    | 80%                 | Linked List                  |
| CTree          | In Progress         | General binary tree          |

## Containers Under Development

- CMap: Key-value mapping table
- CSet: Collection set

## Note

- Almost no comments have been added to the code in this project. If you have difficulty reading the code, please use this [Wiki](https://catisnotfound.github.io/CContainerKit-Wiki/) together.
- Feel free to ask questions or provide suggestions in the Issues to improve the project together.

## License Agreement

This project is licensed under the [MIT License](LICENSE.md) for licensing. Please read and comply with the license agreement before use.