数据结构--元素操作（phoneNote.h）

#ifndef __PHONENOTE_H__
#define __PHONENOTE_H__

/// @brief 通讯信息
typedef struct PhoneNote{
    
    char name[32];/// @brief 姓名     
    char address[128];/// @brief 地址    
    char phone[16]; /// @brief 电话    
    int age;/// @brief 年龄    
    int gender;/// @brief 性别        
}PhoneNote ;

/// @brief 创建通讯信息
/// @return 通讯信息指针
PhoneNote * phoneNote_creat();
/// @brief 打印通讯信息
/// @param p 通讯信息
void phoneNote_printw(PhoneNote *p);
/// @brief 写入通讯信息
/// @param p 通讯信息
/// @param name 姓名
/// @param addr 地址
/// @param phone 电话
/// @param age 年龄
/// @param gender 性别  0:女性; 1:男性；
/// @return 状态 0：写入成功
int  phoneNote_Write( PhoneNote *p,const char* name,const char* addr,  
                    const char* phone,int age,int gender);
/// @brief 标准输入通讯信息（键盘）
/// @return 通讯信息指针
PhoneNote* phoneNote_scanf();
/// @brief 查询通讯信息
/// @param p 通讯信息
/// @param key 关键字
/// @param value 值
/// @return 符合条件通讯信息指针 NULL不符合条件
PhoneNote* phoneNote_search(PhoneNote *p,const char* key,const char* value);
/// @brief 交换通讯信息
/// @param p1 通讯信息1
/// @param p2 通讯信息2
/// @return 状态 0:正常
int phoneNote_swap(PhoneNote *p1,PhoneNote* p2);

/// @brief 比较通讯信息
/// @param p1 通讯信息1
/// @param p2 通讯信息2
/// @param key 关键字
/// @return 状态 1:通讯信息1>通讯信息2
int phoneNote_cmp(PhoneNote *p1,PhoneNote* p2, const char* key);
/// @brief 检查键盘输入字符串信息
/// @param caption 说明
/// @param key 关键字
/// @param size 字符串最大空间
/// @return 状态 0:表示成功
int phoneNote_scanf_str(const char* caption, char* key,int size);
/// @brief 检查键盘输入整形数据
/// @param caption 说明
/// @param key 关键字
/// @return 状态 0:表示成功
int phoneNote_scanf_int(const char* caption,int key);
/// @brief 修改通讯信息
/// @param p 通讯信息
/// @return 状态 0:表示成功
int phoneNote_modify(PhoneNote *p);
/// @brief 测试函数（主函数）
/// @param argc 参数个数
/// @param argv 参数内容
/// @return 状态 0:表示成功
int phoneNote_main(int argc, char const *argv[]);
#endif