LayerCOS_Layer
ObjectCosNull

There is only one NULL object, which is used to fill empty or uninitialized positions in arrays or dictionaries. See Section 3.2.8 in the PDF Reference for details.



Method Summary
 Method
 
CosObj CosNewNull()
Returns a direct object of type CosNull. This NULL object is said to be invalid. You can compare an object to NULL using either of the following methods (the second is more efficient):




Method Detail
CosNewNull()
Product availability: All
Platform availability: All

Syntax

CosObj CosNewNull()

Returns a direct object of type CosNull. This NULL object is said to be invalid. You can compare an object to NULL using either of the following methods (the second is more efficient):

CosObjEqual(obj, CosNewNull());

CosObjGetType(obj) == CosNull;

In general, use CosNewNull() only to initialize a local variable or pass a parameter. NULL objects may be stored as array elements, but not as dictionary values. The following statements are equivalent:

CosDictPut(dict, key, CosNewNull());

CosDictRemove(dict, key);

Returns

A NULL Cos object.

See Also

Since

PI_COS_VERSION >= 0x00020000

File: CosProcs.h
Line: 142