L_DicomGetFirstCodedConcept

#include "ltdic.h"

L_LTDIC_API pDICOMCODEDCONCEPT L_DicomGetFirstCodedConcept(pContextGroup)

Returns a pointer to the first Coded Concept in the specified Context Group.

Parameters

pDICOMCONTEXTGROUP pContextGroup

Pointer to a DICOMCONTEXTGROUP structure that specifies a Context Group in the Context Group Table. The function returns a pointer to the first Coded Concept in this Group, if it contains any.

Returns

Value Meaning
!NULL Pointer to a DICOMCODEDCONCEPT structure that specifies the first Coded Concept in the specified Context Group.
NULL The specified Context Group does not contain any Coded Concepts.

Comments

Along with this function, the following functions can be used to maneuver through the Coded Concepts of a Context Group in the Context Group Table:

You can also use the L_DicomGetCountCodedConcept and L_DicomFindIndexCodedConcept functions to enumerate the Coded Concepts.

Use the L_DicomGetCodedConceptGroup function to determine which Context Group contains a specific Coded Concept.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

L_INT DicomGetFirstCodedConceptExample(pDICOMCONTEXTGROUP pGroup) 
{ 
   pDICOMCODEDCONCEPT pConcept; 
   L_INT nRet; 
 
   // Is it a valid pointer?  
   if (!L_DicomExistsContextGroup (pGroup))  
      return DICOM_ERROR_NULL_PTR; 
 
   // Enumerate the Coded Concepts in the Context Group (3 possible ways)  
#if 1 
 
   // One possible way to enumerate the Coded Concepts 
   pConcept = L_DicomGetFirstCodedConcept(pGroup);  
   while (pConcept)  
   { 
      // Refer to the example of L_DicomGetCodedConceptGroup for 
      // the function DicomGetCodedConceptGroupExample 
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE); 
      if (nRet != SUCCESS) 
         break; 
 
      pConcept = L_DicomGetNextCodedConcept (pConcept);  
   } 
 
#elif 0 
    
   // Another way to enumerate the Coded Concepts 
   uConceptsCount = L_DicomGetCountCodedConcept (pGroup);  
   for (i = 0; i < uConceptsCount; i++) 
   { 
      pConcept = L_DicomFindIndexCodedConcept (pGroup, i);  
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE); 
      if (nRet != SUCCESS) 
         break; 
   } 
 
#elif 0 
 
   // A third way to enumerate the Coded Concepts 
   pConcept = L_DicomGetLastCodedConcept (pGroup);  
   while (pConcept)  
   { 
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE); 
      if (nRet != SUCCESS) 
         break; 
 
      pConcept = L_DicomGetPrevCodedConcept (pConcept);  
   } 
#endif 
   return DICOM_SUCCESS; 
} 
Help Version 20.0.2019.9.20
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help