• NDAttributeList源码解析及测试

     NDAttributeList对象的源代码：

    1. #include 
    2.  
    3. #include "NDAttributeList.h"
    4.  
    5. /** NDAttributeList构造器：初始化ELLLIST，创建互斥量
    6.   */
    7. NDAttributeList::NDAttributeList()
    8. {
    9.   ellInit(&this->list_);
    10.   this->lock_ = epicsMutexCreate();
    11. }
    12.  
    13. /** NDAttributeList析构函数：清除所有NDAttribute对象，释放ELLLIST，销毁互斥量
    14.   */
    15. NDAttributeList::~NDAttributeList()
    16. {
    17.   this->clear();
    18.   ellFree(&this->list_);
    19.   epicsMutexDestroy(this->lock_);
    20. }
    21.  
    22. /** 添加一个属性到这个列表。
    23.   * 如果一个相同名称的属性已经存在，则删除这个已有属性并且用这个新属性替代。
    24.   * [in] pAttribute：指向要添加的属性的指针 .
    25.   */
    26. int NDAttributeList::add(NDAttribute *pAttribute)
    27. {
    28.   //const char *functionName = "NDAttributeList::add";
    29.  
    30.   epicsMutexLock(this->lock_);
    31.   /* 移除这个名称的任何已有顺序 */
    32.   this->remove(pAttribute->name_.c_str());
    33.   // 把这个属性添加到链表中
    34.   ellAdd(&this->list_, &pAttribute->listNode_.node);
    35.   epicsMutexUnlock(this->lock_);
    36.   return(ND_SUCCESS);
    37. }
    38.  
    39. /** 添加一个NDAttribute对象到链表中
    40.   * 这是一个用于添加一个属性到一个链表的便捷函数.
    41.   * 它首先搜寻这个链表查看是否有存在一个相同名称的属性。
    42.   * 如果存在，它仅更改已有属性的性质。如果不存在，它用指定性质创建一个新的属性。
    43.   * 重要：这个方法仅能够创建NDAttribute基类类型的属性，而非派生类属性。
    44.   * 要添加一个派生类的属性到一个列表，必须使用NDAttributeList::add(NDAttribute *)方法。
    45.   * [in] pName ：要被添加的属性的名称.
    46.   * [in] pDescription：这个属性的描述.
    47.   * [in] dataType ：这个属性的数据类型.
    48.   * [in] pValue ：指向用于这个属性的值的指针.
    49.   *
    50.   */
    51. NDAttribute* NDAttributeList::add(const char *pName, const char *pDescription, NDAttrDataType_t dataType, void *pValue)
    52. {
    53.   //const char *functionName = "NDAttributeList::add";
    54.   NDAttribute *pAttribute;
    55.  
    56.   epicsMutexLock(this->lock_);
    57.   pAttribute = this->find(pName);
    58.   if (pAttribute) {
    59.     pAttribute->setValue(pValue);
    60.   } else {
    61.     pAttribute = new NDAttribute(pName, pDescription, NDAttrSourceDriver, "Driver", dataType, pValue);
    62.     ellAdd(&this->list_, &pAttribute->listNode_.node);
    63.   }
    64.   epicsMutexUnlock(this->lock_);
    65.   return(pAttribute);
    66. }
    67.  
    68.  
    69.  
    70. /**  通过名称查找一个属性；搜索现在是区分大小写的。
    71.   * [in] pName ： 要被查找的属性的名称.
    72.   * 返回：如果找到，一个指向这个属性的指针，如果没有找到，返回NULL .
    73.   */
    74. NDAttribute* NDAttributeList::find(const char *pName)
    75. {
    76.   NDAttribute *pAttribute;
    77.   NDAttributeListNode *pListNode;
    78.   //const char *functionName = "NDAttributeList::find";
    79.  
    80.   epicsMutexLock(this->lock_);
    81.   pListNode = (NDAttributeListNode *)ellFirst(&this->list_);
    82.   while (pListNode) {
    83.     pAttribute = pListNode->pNDAttribute;
    84.     if (pAttribute->name_ == pName) goto done;
    85.     pListNode = (NDAttributeListNode *)ellNext(&pListNode->node);
    86.   }
    87.   pAttribute = NULL;
    88.  
    89.   done:
    90.   epicsMutexUnlock(this->lock_);
    91.   return(pAttribute);
    92. }
    93.  
    94. /** 查找在属性链表中下一个属性。
    95.   * [in] pAttributeIn ： 一个指向链表中前一个属性的指针
    96.   * 如果NULL，返回链表中第一个属性
    97.   * 返回：如果有，返回一个指向下一个属性的指针，
    98.   * 如果在链表中没有更多属性了，返回NULL。
    99.   */
    100. NDAttribute* NDAttributeList::next(NDAttribute *pAttributeIn)
    101. {
    102.   NDAttribute *pAttribute=NULL;
    103.   NDAttributeListNode *pListNode;
    104.   //const char *functionName = "NDAttributeList::next";
    105.  
    106.   epicsMutexLock(this->lock_);
    107.   if (!pAttributeIn) {
    108.     pListNode = (NDAttributeListNode *)ellFirst(&this->list_);
    109.    }
    110.   else {
    111.     pListNode = (NDAttributeListNode *)ellNext(&pAttributeIn->listNode_.node);
    112.   }
    113.   if (pListNode) pAttribute = pListNode->pNDAttribute;
    114.   epicsMutexUnlock(this->lock_);
    115.   return(pAttribute);
    116. }
    117.  
    118. /** 返回属性链表中属性的总数。
    119.   * 返回：返回属性数目  */
    120. int NDAttributeList::count()
    121. {
    122.   //const char *functionName = "NDAttributeList::count";
    123.   // 链表中节点数目
    124.   return ellCount(&this->list_);
    125. }
    126.  
    127. /** 从链表中移除一个属性。
    128.   * [in] pName ： 要被删除的属性名称.
    129.   * 返回：如果找到这个属性并且被删除，返回ND_SUCCESS。
    130.   * 如果没有找到这个属性，ND_ERRORR
    131.   */
    132. int NDAttributeList::remove(const char *pName)
    133. {
    134.   NDAttribute *pAttribute;
    135.   int status = ND_ERROR;
    136.   //const char *functionName = "NDAttributeList::remove";
    137.  
    138.   epicsMutexLock(this->lock_);
    139.   pAttribute = this->find(pName);
    140.   if (!pAttribute) goto done; // 指定名称的属性不存在，则直接结束
    141.   ellDelete(&this->list_, &pAttribute->listNode_.node); // 从链表中删除这个属性
    142.   delete pAttribute;
    143.   status = ND_SUCCESS;
    144.  
    145.   done:
    146.   epicsMutexUnlock(this->lock_);
    147.   return(status);
    148. }
    149.  
    150. /**  从链表删除所有属性 */
    151. int NDAttributeList::clear()
    152. {
    153.   NDAttribute *pAttribute;
    154.   NDAttributeListNode *pListNode;
    155.   //const char *functionName = "NDAttributeList::clear";
    156.  
    157.   epicsMutexLock(this->lock_);
    158.   pListNode = (NDAttributeListNode *)ellFirst(&this->list_); // 第一个节点
    159.   while (pListNode) {
    160.     pAttribute = pListNode->pNDAttribute;
    161.     ellDelete(&this->list_, &pListNode->node);
    162.     delete pAttribute;
    163.     pListNode = (NDAttributeListNode *)ellFirst(&this->list_);
    164.   }
    165.   epicsMutexUnlock(this->lock_);
    166.   return(ND_SUCCESS);
    167. }
    168.  
    169. /** 
    170.   * 从一个属性链表复制所有属性到另一个属性链表。
    171.   * 它是高效的，因而如果这个属性已经存在于这个输出链表，它仅复制这些性质，并且内存分配被最小化。
    172.   * 这些属性被添加到在输出链表中已经存在的任何已有属性中。
    173.   * [out]pListNode: 指向要复制到的输出属性链表的指针
    174.   */
    175. int NDAttributeList::copy(NDAttributeList *pListOut)
    176. {
    177.   NDAttribute *pAttrIn, *pAttrOut, *pFound;
    178.   NDAttributeListNode *pListNode;
    179.   //const char *functionName = "NDAttributeList::copy";
    180.  
    181.   epicsMutexLock(this->lock_);
    182.   pListNode = (NDAttributeListNode *)ellFirst(&this->list_); // 获取第一个属性所在节点
    183.   while (pListNode) {
    184.     pAttrIn = pListNode->pNDAttribute; // 获取属性NDAttribute对象
    185.     /* 查找输出链表中是否已经存在相同名称的属性  */
    186.     pFound = pListOut->find(pAttrIn->name_.c_str());
    187.     /* 如果输出链表中存在相同名称的，则将仅将输入链表中属性对象的属性值复制到输出链表中属性对象的属性值中
    188.        如果不存在，则拷贝构造一个输入链表中的属性对象
    189.     */
    190.     pAttrOut = pAttrIn->copy(pFound);
    191.     /* 如果pFound是NULL，则一个复制窗一个新属性，需要添加它到输出链表*/
    192.     if (!pFound) pListOut->add(pAttrOut); 
    193.     pListNode = (NDAttributeListNode *)ellNext(&pListNode->node);// 输入链表中当前节点的下一个节点
    194.   }
    195.   epicsMutexUnlock(this->lock_);
    196.   return(ND_SUCCESS);
    197. }
    198.  
    199. /** 
    200.   * 更新链表中所有属性值；为链表中每个属性调用NDAttribute::updateValue()
    201.   */
    202. int NDAttributeList::updateValues()
    203. {
    204.   NDAttribute *pAttribute;
    205.   NDAttributeListNode *pListNode;
    206.   //const char *functionName = "NDAttributeList::updateValues";
    207.  
    208.   epicsMutexLock(this->lock_);
    209.   pListNode = (NDAttributeListNode *)ellFirst(&this->list_);
    210.   while (pListNode) {// 调用链表中每个节点上每个NDAttribute对象的updateValue()
    211.     pAttribute = pListNode->pNDAttribute;
    212.     pAttribute->updateValue();
    213.     pListNode = (NDAttributeListNode *)ellNext(&pListNode->node);
    214.   }
    215.   epicsMutexUnlock(this->lock_);
    216.   return(ND_SUCCESS);
    217. }
    218.  
    219. /** 报告这个属性链表的性质。
    220.   * [in] fp ：报告输出的文件指针
    221.   * [in] details ： 所需报告的详细程度；如果>10, 为每个属性调用NDAttribute::report()。
    222.   */
    223. int NDAttributeList::report(FILE *fp, int details)
    224. {
    225.   NDAttribute *pAttribute;
    226.   NDAttributeListNode *pListNode;
    227.  
    228.   epicsMutexLock(this->lock_);
    229.   fprintf(fp, "\n");
    230.   fprintf(fp, "NDAttributeList: address=%p:\n", this);
    231.   fprintf(fp, "  number of attributes=%d\n", this->count());
    232.   if (details > 10) {
    233.     pListNode = (NDAttributeListNode *) ellFirst(&this->list_);
    234.     while (pListNode) {
    235.       pAttribute = (NDAttribute *)pListNode->pNDAttribute;
    236.       pAttribute->report(fp, details);
    237.       pListNode = (NDAttributeListNode *) ellNext(&pListNode->node);
    238.     }
    239.   }
    240.   epicsMutexUnlock(this->lock_);
    241.   return ND_SUCCESS;
    242. }

    测试代码：

    1. #include 
    2. #include 
    3. #include 
    4. #include "NDAttribute.h"
    5. #include "NDAttributeList.h"
    6.  
    7. int main()
    8. {
    9.         NDAttributeList * list = new NDAttributeList();
    10.         epicsInt8 i8 = 10;
    11.         epicsInt16 i16 = 256;
    12.         epicsInt32 i32 = 100000;
    13.         epicsFloat64 f64 = 3.14;
    14.         const char * str = "Hello World";
    15.  
    16.         NDAttrDataType_t types[] = {NDAttrInt8, NDAttrInt16, NDAttrInt32, NDAttrFloat64, NDAttrString};
    17.         void * ptrValue[] = {&i8, &i16, &i32, &f64, (void *)str};
    18.         const char * pDescription[] = {"NDInt8", "NDInt16", "NDInt32", "NDFloat64", "NDString"};
    19.         const char * name[] = {"i8Attribute", "i16Attribute", "i32Attribute", "f64Attribute", "strAttribute"};
    20.  
    21.         int i;
    22.  
    23.         for (i = 0; i < 5; i++){
    24.                 list->add(name[i], pDescription[i], types[i], ptrValue[i]);
    25.         }
    26.  
    27.         printf("Total number of Attributes: %d\n", list->count());
    28.         printf("Find the attribute of name: %s\n", name[4]);
    29.         NDAttribute * pAttribute = list->find(name[4]);
    30.  
    31.         if (pAttribute){
    32.                 printf("find the attribute of name %s\n", name[4]);
    33.                 pAttribute->report(stdout, 10);
    34.         }
    35.         else
    36.         {
    37.                 printf("can not find the attribute of the name: %s\n", name[4]);
    38.         }
    39.  
    40.         printf("Display all attribute: \n");
    41.         pAttribute = list->next(NULL);
    42.  
    43.         printf("\n");
    44.  
    45.         i = 0;
    46.         while (pAttribute){
    47.                 printf("Num:%d", ++i);
    48.                 pAttribute->report(stdout, 10);
    49.                 pAttribute = list->next(pAttribute);
    50.         }
    51.  
    52.         printf("Delete the attribute of the name: %s\n", name[4]);
    53.         list->remove(name[4]);
    54.         printf("Total number of Attributes: %d\n", list->count());
    55.         if (pAttribute){
    56.                 printf("find the attribute of name %s\n", name[4]);
    57.                 pAttribute->report(stdout, 10);
    58.         }
    59.         else
    60.         {
    61.                 printf("can not find the attribute of the name: %s\n", name[4]);
    62.         }
    63.  
    64.  
    65.         return 0;
    66. }

    编译以上源代码，进行测试，解释结果如下：

    1. Total number of Attributes: 5
    2. Find the attribute of name: strAttribute
    3. find the attribute of name strAttribute
    4.  
    5. NDAttribute, address=0xaaaac52ab020:
    6.   name=strAttribute
    7.   description=NDString
    8.   source type=0
    9.   source type string=NDAttrSourceDriver
    10.   source=Driver
    11.   dataType=NDAttrString
    12.   value=Hello World
    13. Display all attribute:
    14.  
    15. Num:1
    16. NDAttribute, address=0xaaaac52aabe0:
    17.   name=i8Attribute
    18.   description=NDInt8
    19.   source type=0
    20.   source type string=NDAttrSourceDriver
    21.   source=Driver
    22.   dataType=NDAttrInt8
    23.   value=10
    24. Num:2
    25. NDAttribute, address=0xaaaac52aacf0:
    26.   name=i16Attribute
    27.   description=NDInt16
    28.   source type=0
    29.   source type string=NDAttrSourceDriver
    30.   source=Driver
    31.   dataType=NDAttrInt16
    32.   value=256
    33. Num:3
    34. NDAttribute, address=0xaaaac52aae00:
    35.   name=i32Attribute
    36.   description=NDInt32
    37.   source type=0
    38.   source type string=NDAttrSourceDriver
    39.   source=Driver
    40.   dataType=NDAttrInt32
    41.   value=100000
    42. Num:4
    43. NDAttribute, address=0xaaaac52aaf10:
    44.   name=f64Attribute
    45.   description=NDFloat64
    46.   source type=0
    47.   source type string=NDAttrSourceDriver
    48.   source=Driver
    49.   dataType=NDAttrFloat64
    50.   value=3.140000
    51. Num:5
    52. NDAttribute, address=0xaaaac52ab020:
    53.   name=strAttribute
    54.   description=NDString
    55.   source type=0
    56.   source type string=NDAttrSourceDriver
    57.   source=Driver
    58.   dataType=NDAttrString
    59.   value=Hello World
    60. Delete the attribute of the name: strAttribute
    61. Total number of Attributes: 4
    62. can not find the attribute of the name: strAttribute
  • 相关阅读:
    80个在线小游戏源码
    基础 | 并发编程 - [Lock 使用 & 对比 synchronized]
    C++ Qt 学习（九）：模型视图代理
    【Redis面试】基础题总结（上）
    前端工作总结212-账号绑定逻辑复杂
    java毕业设计旅游网站设计mybatis+源码+调试部署+系统+数据库+lw
    二极管：Irush与我相干！
    webpack打包gz文件，nginx开启gzip压缩
    周一见！距离阿里巴巴开源开放周还有3天
    SpringBoot
  • 原文地址：https://blog.csdn.net/yuyuyuliang00/article/details/133581159