Functions and Directives Functions and Directives

Function _conPutL() Foundation

Assigns a logical value to a container or creates a new logical container.

Syntax
ContainerHandle _conPutL(ContainerHandle ch, BOOL lValue);
Parameters
ContainerHandle ch
Handle of any container or NULLCONTAINER.
BOOL lValue
Logical value (TRUE or FALSE).
Return

Returns either the passed or the newly created container handle. The return value is NULLCONTAINER if an error occurs.

Description

_conPutL() is used to assign a logical value to a container. When the passed container handle has the value NULLCONTAINER, a new logical container is created. Otherwise the value of the passed container is changed.

When a new container is created, it must be released with _conRelease() as soon as it is no longer needed.

Examples
/* 
Returns a logical value as a return value to Xbase++. 
*/ 
#include <xppcon.h> 

ContainerHandle  hLogic; 
BOOL             logic; 


/* Assigns ... logic a value */ 

hLogic = _conPutL(NULLCONTAINER, logic); 
if (hLogic != NULLCONTAINER) 
{ 
_conReturn(<pList>, hLogic); 
_conRelease(hLogic); 
} 
else 
{ 
/* error occurred: return NIL */ 
_conReturn(<pList>, NULLCONTAINER); 
} 
return;
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.