PutAttr Method

Writes an XML attribute.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int PutAttr(const char* lpszName, const char* lpszNamespaceURI, const char* lpszValue);

Unicode (Windows)
INT PutAttr(LPCWSTR lpszName, LPCWSTR lpszNamespaceURI, LPCWSTR lpszValue);

- (void)putAttr:(NSString*)name :(NSString*)namespaceURI :(NSString*)value;

#define MID_XML_PUTATTR 10

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_XML_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Writes an XML attribute on the currently opened XML element. It must be called right after calling StartElement and before any calls to PutString, PutComment or PutRaw.

If Name is a local name without a prefix, the class will automatically introduce a new xmlns="NamespaceURI" attribute if necessary.

If Name is in the form prefix:local, then class will automatically introduce a new xmlns:prefix="NamespaceURI" as necessary.

Certain attribute names will be handled in special ways by this method. If Name is "xmlns" or uses the "xmlns" prefix, the attribute will be interpreted as a namespace declaration, regardless of the value of NamespaceURI. Similarly, any attribute using the "xml" prefix will be interpreted as a special attribute (like "xml:lang") and NamespaceURI will be ignored.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)