NAME
        CxFilter -- create a commodity filter object. (V36)

   SYNOPSIS
        filterObj = CxFilter(description);

        cxobj *cxfilter(strptr)

   FUNCTION
        Creates an input event filter object that matches the
        'description' string. If 'description' is NULL, the filter will not
        match any messages.

        A filter may be modified by the functions setfilter(), using
        a description string, and setfilterix(), which takes a
        binary input expression as a parameter.

        This function is a C-language macro for createcxobj(), defined
        in <libraries/commodities.h>.

   INPUTS
        description - the description string in the same format as strings
                      expected by commodities.library/setfilter()

   RESULTS
        filterObj - a pointer to the filter object, or NULL if there
                    was not enough memory. If there is a problem in the
                    description string, the internal error code of the filter
                    object will be set to so indicate. This error code may be
                    interrogated using the function cxobjerror().

   SEE ALSO
        commodities.library/createcxobj(), commodities.library/setfilter(),
        commodities.library/setfilterix(), commodities.library/cxobjerror()