edmiValueIn


 

EdmiError edmiValueIn(SdaiAggr          aggr,
                       SdaiPrimitiveType dataType,  
                       SdaiLogical       *result, 
                       . . .); 

Implements the Express built in function Value_In as defined in section 15.28 Value_in – membership function; in ISO 10303-11:1994(E) : The EXPRESS Language Reference Manual. The Value_in function returns a SdaiLogical value depending on whether or not the specified <value> is a member in the specified <aggr> or not. This operation uses value comparison (deep comparison). This operation is only applicable on data models. The actual data model must be open before this operation can be successfully performed.

Arguments


TypeNameComment
SdaiAggr

aggr

A numeric aggregateID that uniquely identifies the aggregate of interest in the EDMdatabase. The aggregateID is returned when the aggregate is created or it can be retrieved with an EDMinterface get operation.

SdaiPrimitiveType

dataType

Specifies the data type ( primitive type) of the specified <value> argument that will be checked for existing in the specified <aggr> argument. The value of this argument must be one of the following legal data types: sdaiINTEGER, sdaiREAL, sdaiBOOLEAN, sdaiLOGICAL, sdaiSTRING, sdaiENUMERATION, sdaiBINARY, sdaiAGGR, sdaiINSTANCE or sdaiSELECT.

SdaiLogical

result

Address of a SdaiLogical variable that will receive the result of the Value_In operation. The returned result is as follows:

  • sdaiTRUE: <value> found in aggregate <aggr>
  • sdaiFALSE: <value> not found in aggregate <aggr>
  • sdaiUNKNOWN: Unpredictable result due to unset values or error in operation. Use sdaiErrorQuery to check for error in operation.
 

value

The actual data value passed to the Value_In operation.

Return Value


Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options


 

Example


 

EdmiError rstat;
 SdaiAggr aggr;
 SdaiLogical result;
 SdaiInstance documentId;
 . . .
 if (rstat = edmiValueIn (aggr,
 sdaiINSTANCE, 
 &result, 
 documentId)) { 
 /* Error in operation */ 
 printf("\nError: %s in edmiValueIn \n", 
 edmiGetErrorText(rstat)); 
 goto error; 
 }
 switch (result) {
 case sdaiTRUE: 
 . . . /* Value found in aggregate */ 
 break; 
 case sdaiFALSE: 
 . . . /* Value not found in aggregate */ 
 break; 
 default: 
 . . . /* Unpredictable result */ 
 break; 
 }
 . . .

 

See also

Filter by label

There are no items with the selected labels at this time.