GOP/GOP_AttribListParse.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Side Effects
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 *  This class contains some static utility methods for parsing lists of
 *  attributes.
 *
 */

#ifndef __GOP_AttribListParse_h__
#define __GOP_AttribListParse_h__

#include "GOP_API.h"
#include <UT/UT_PtrArray.h>
#include <GEO/GEO_AttributeOwner.h>

class UT_String;
class GB_Attribute;
class GB_AttributeDict;
class GEO_AttributeHandleList;

enum GOP_AttribParseError
{
    GOP_AP_ERROR_NONE = 0,
    GOP_AP_ERROR_ATTRIB_UNKNOWN,
    GOP_AP_ERROR_ATTRIB_DUPLICATED,
    GOP_AP_ERROR_ATTRIB_REDUNDANT,
    GOP_AP_ERROR_PATTERN_MATCH_UNSUPPORTED,
    GOP_AP_ERROR_INCOMPATIBLE_ATTRIBUTE_LIST_STRING_PATTERNS
};

typedef void (*GOP_AttribParseErrorCallback) (GOP_AttribParseError,
                                              const char *, void *);
typedef bool (*GOP_AttribParseConfirmCallback) (const GB_Attribute *,
                                                void *);

//___________________________________________________________________________

class GOP_API GOP_AttribListParse
{
public:
    // Parses attribute list string to match "P" and "Pw".  Returns 0 if
    // no match, 3 if "P" matches but not "Pw", and 4 if "Pw" matches.
    // Also removes instances of "P" and "Pw" from the string.
    // ERRORS:
    //   GOP_AP_ERROR_ATTRIB_DUPLICATED
    //   GOP_AP_ERROR_ATTRIB_REDUNDANT
    static int parsePAndPw(UT_String &attriblist,
                                  GOP_AttribParseErrorCallback errorCB = 0);

    // Parses attribute list string and verifies syntax as well as the
    // existence of the attributes specified.  Can return the nonexistent
    // attributes in the badlist parameter.
    // ERRORS:
    //   GOP_AP_ERROR_ATTRIB_UNKNOWN
    //   GOP_AP_ERROR_ATTRIB_DUPLICATED
    static bool isAttribListValid(const GB_AttributeDict &dict,
                                  const UT_String &attriblist,
                                  GOP_AttribParseErrorCallback errorCB = 0,
                                  void *errordata = 0, UT_String *badlist = 0);

    // Parses the attribute list string and extracts the attribute pointers
    // into the supplied array.
    // ERRORS:
    //   GOP_AP_ERROR_PATTERN_MATCH_UNSUPPORTED (warning)
    static void parseAttribList(const GB_AttributeDict &dict,
                                UT_String &attriblist,
                                UT_PtrArray<GB_Attribute *> &attribarray,
                                GOP_AttribParseConfirmCallback confirmCB = 0,
                                void *confirmdata = 0,
                                GOP_AttribParseErrorCallback errorCB = 0,
                                void *errordata = 0);

    // Parses the attribute list string and extracts the attribute pointers
    // into the supplied attribute list handle.
    // ERRORS:
    //   GOP_AP_ERROR_PATTERN_MATCH_UNSUPPORTED (warning)
    static void parseAttribList(GEO_AttributeHandleList &attriblist,
                                GEO_AttributeOwner owner,
                                UT_String &attriblist_str,
                                GOP_AttribParseConfirmCallback confirmCB=0,
                                void *confirmdata = 0,
                                GOP_AttribParseErrorCallback errorCB = 0,
                                void *errordata = 0);

    // Pattern matches the incoming attribute string with the input attribute
    // list string and returns the corresponding outgoing attribute string
    // from the output attribute list string.
    // ERRORS:
    //   GOP_AP_ERROR_INCOMPATIBLE_ATTRIBUTE_LIST_STRING_PATTERNS
    static char *renameAttrib(UT_String &attrib,
                              const UT_String &inattriblist, 
                              const UT_String &outattriblist,
                              GOP_AttribParseErrorCallback errorCB = 0,
                              void *errordata = 0);
};

#endif

---