通讯录的实现

1. • 需求分析：

设计一个通讯录管理系统，能够长时间地存储亲朋好友的联系方式以及其信息（姓名，年龄，性别，电话号码，居住地址），并能够在有需要的时候，能够及时地找出其信息。

2. • 系统设计：

2.1系统功能的设计：

该系统应有添加，删除，修改，查找相关联系人的相关信息等功能。分为以下几类功能：
添加相关联系人：录入新的联系人的相关信息。
删除相关联系人：从系统中去除指定的联系人的所有信息。
修改相关联系人的信息：找出想要修改的联系人，并对该联系人的相关信息进行修改。
查找相关联系人：从系统中，找出该联系人，并显示他的个人信息。
查看所有联系人信息：从系统中，显示所有联系人的相关信息。
保存通讯录：将此次设置的相关信息输出到文件中，并保存在文件当中。
读取历史通讯录：从历史的文件当中读取相关的信息，以保证通讯录的长时间保存联系人信息。

2.2系统数据的设计：

以一个头文件和两个源文件祖成：分别为contact.h、contact.c、test.c组成。
其中contact.h文件用于存放相关头文件的声明与自定义函数的声明。
contact.c文件用于存放相关自定义函数的实现。
test.c文件用于测试，存放main函数等。

由于该系统围绕着人的基本信息，所以定义一个结构体用于存放联系人的基本信息，宏定义相关信息的最大值，由于想要通讯录为动态的，可随时增添或删减联系人，那么定义一个结构体用于对该系统进行扩容操作。

#define NAME_MAX 20//姓名的最大长度
#define TELE_MAX 12//电话号码的最大长度
#define ADDR_MAX 30//居住地址的最大长度
#define SEX_MAX 5//性别的最大长度

#define DEFAULT_SZ 3//初始通讯录的大小
#define INC_SZ 2//一次性扩容的大小

//人的基本信息
typedef struct PeoInfo
{
    char name[NAME_MAX];//姓名
    int age;//年龄
    char sex[SEX_MAX];//性别
    char tele[TELE_MAX];//电话号码
    char addr[ADDR_MAX];//地址
}PeoInfo;

//动态申请空间存储人的信息
typedef struct Contact
{
    PeoInfo* data;//指向存放人的信息和空间
    int sz;//当前已存放的通讯录数据
    int capacity;//当前通讯录的最大容量
}Contact;

3.各类函数的声明和实现：

3.1函数的声明：

//初始化通讯录
void InitContact(Contact* pc);
//销毁通讯录
void DestroyContact(Contact* pc);
//增加联系人
void AddContact(Contact* pc);
//删除指定联系人
void DelContact(Contact* pc);
//显示通讯录中的信息
void ShowContact( Contact* pc);
//查找指定联系人
void SearchContact( Contact* pc);
//修改指定联系人
void ModifyContact(Contact* pc);
//保存通讯录中的信息到文件中
void SaveContact(Contact* pc);
//加载文件信息到通讯录
void LoadContact(Contact* pc);

3.2函数的实现：

3.2.1：初始化通讯录

void InitContact(Contact * pc)
{
    assert(pc);
    pc->sz = 0;
    PeoInfo* ptr = (PeoInfo*)calloc(DEFAULT_SZ, sizeof(PeoInfo));
    if (ptr == NULL)
    {
        perror("InitContact::calloc");
        return;
    }
    pc->data = ptr;
    pc->capacity = DEFAULT_SZ;
    //加载文件信息到通讯录
    LoadContact(pc);
}

3.2.2销毁通讯录

void DestroyContact(Contact* pc)
{
    free(pc->data);
    pc->data = NULL;
    pc->capacity = 0;
    pc->sz = 0;
    pc = NULL;
}

3.2.3添加联系人

void AddContact(Contact* pc)
{
    assert(pc);
    check_capacity(pc);

    //增加一个人的信息
    printf("请输入名字:>");
    scanf("%s", pc->data[pc->sz].name);
    printf("请输入年龄:>");
    scanf("%d", &(pc->data[pc->sz].age));
    printf("请输入性别:>");
    scanf("%s", pc->data[pc->sz].sex);
    printf("请输入地址:>");
    scanf("%s", pc->data[pc->sz].addr);
    printf("请输入电话:>");
    scanf("%s", pc->data[pc->sz].tele);

    pc->sz++;
}

3.2.4删除指定联系人

void DelContact(Contact* pc)
{
    assert(pc);

    char name[NAME_MAX] = { 0 };
    if (pc->sz == 0)
    {
        printf("通讯录为空，无法删除\n");
        return;
    }
    //删除
    //找到要删除的人
    printf("请输入要删除的人的名字:>");
    scanf("%s", name);
    int ret = FindByName(pc, name);
    if (-1 == ret)
    {
        printf("要删除的人不存在\n");
        return;
    }

3.2.5显示通讯录中的信息

void ShowContact(const Contact* pc)
{
    assert(pc);
    int i = 0;
    printf("%-20s\t%-4s\t%-5s\t%-20s\t%-12s\n", "名字", "年龄", "性别", "地址", "电话");
    for (i = 0; i < pc->sz; i++)
    {
        printf("%-20s\t%-4d\t%-5s\t%-20s\t%-12s\n", pc->data[i].name,
            pc->data[i].age,
            pc->data[i].sex,
            pc->data[i].addr,
            pc->data[i].tele);
    }
}

3.2.6查找指定联系人

void SearchContact(const Contact* pc)
{
    assert(pc);
    char name[NAME_MAX] = { 0 };
    printf("请输入要查找人的名字:>");
    scanf("%s", name);
    int pos = FindByName(pc, name);
    if (-1 == pos)
    {
        printf("要查找的人不存在\n");
        return;
    }
    //打印信息
    printf("%-20s\t%-4s\t%-5s\t%-20s\t%-12s\n", "名字", "年龄", "性别", "地址", "电话");
    printf("%-20s\t%-4d\t%-5s\t%-20s\t%-12s\n", pc->data[pos].name,
        pc->data[pos].age,
        pc->data[pos].sex,
        pc->data[pos].addr,
        pc->data[pos].tele);
}

3.2.7修改指定联系人

void ModifyContact(Contact* pc)
{
    assert(pc);
    char name[NAME_MAX] = { 0 };
    printf("请输入要修改人的名字:>");
    scanf("%s", name);
    int pos = FindByName(pc, name);
    if (-1 == pos)
    {
        printf("要修改的人不存在\n");
        return;
    }

    printf("请输入名字:>");
    scanf("%s", pc->data[pos].name);
    printf("请输入年龄:>");
    scanf("%d", &(pc->data[pos].age));
    printf("请输入性别:>");
    scanf("%s", pc->data[pos].sex);
    printf("请输入地址:>");
    scanf("%s", pc->data[pos].addr);
    printf("请输入电话:>");
    scanf("%s", pc->data[pos].tele);

    printf("修改完成\n");
}

3.2.8保存通讯录中的信息到文件中

void SaveContact(Contact* pc)
{
    //写数据
    //1, 打开文件
    FILE* pf = fopen("contact.txt", "wb");
    if (NULL == pf)
    {
        perror("SaveContact");
    }
    else
    {
        //写数据
        int i = 0;
        for (i = 0; i < pc->sz; i++)
        {
            fwrite(pc->data + i, sizeof(PeoInfo), 1, pf);
        }
        fclose(pf);
        pf = NULL;
        printf("保存成功\n");
    }
}

3.2.9加载文件信息到通讯录

void LoadContact(Contact* pc)
{
    //读数据
    //1. 打开文件
    FILE* pf = fopen("contact.txt", "rb");
    if (pf == NULL)
    {
        perror("LoadContact");
    }
    else
    {
        //2. 读数据
        PeoInfo tmp = { 0 };
        int i = 0;
        while (fread(&tmp, sizeof(PeoInfo), 1, pf))
        {
            //增容
            check_capacity(pc);
            pc->data[i] = tmp;
            pc->sz++;
            i++;
        }
        fclose(pf);
        pf = NULL;
    }
}

4.系统测试代码与运行：

4.1相关代码的展示：

enum Option//枚举菜单的选项
{
    EXIT,
    ADD,
    DEL,
    SHOW,
    SEARCH,
    MODIFY,
};

void menu()
{
    printf("--------1.ADD--------------\n");
    printf("--------2.DEL--------------\n");
    printf("--------3.SHOW-------------\n");
    printf("--------4.SEARCH-----------\n");
    printf("--------5.MODIFY-----------\n");
    printf("--------0.EXIT-------------\n");
}

void test()
{
    //创建通讯录
    Contact con;
    //初始化通讯录
    InitContact(&con);
    int input = 0;
    do
    {
        menu();
        scanf("%d", &input);
        switch (input)
        {
        case ADD:
            AddContact(&con);
            break;
        case DEL:
            DelContact(&con);
            break;
        case SHOW:
            ShowContact(&con);
            break;
        case SEARCH:
            SearchContact(&con);
            break;
        case MODIFY:
            ModifyContact(&con);
            break;
        case EXIT:
            //退出之前必须先把通讯录存放入文件当中！！！以保证下次的使用
            SaveContact(&con);
            // 存好文件之后必须关闭相对应的文件
            DestroyContact(&con);
            printf("退出通讯录成功\n");
            break;
        default:
            printf("输入错误，请重新输入\n");
            break;
        }
    }while (input);
}
int main()
{
    test();
    return 0;
}

4.2系统运行测试：