Annotation of embedaddon/libxml2/include/libxml/xmlwriter.h, revision 1.1

1.1     ! misho       1: 
        !             2: /*
        !             3:  * Summary: text writing API for XML
        !             4:  * Description: text writing API for XML
        !             5:  *
        !             6:  * Copy: See Copyright for the status of this software.
        !             7:  *
        !             8:  * Author: Alfred Mickautsch <alfred@mickautsch.de>
        !             9:  */
        !            10: 
        !            11: #ifndef __XML_XMLWRITER_H__
        !            12: #define __XML_XMLWRITER_H__
        !            13: 
        !            14: #include <libxml/xmlversion.h>
        !            15: 
        !            16: #ifdef LIBXML_WRITER_ENABLED
        !            17: 
        !            18: #include <stdarg.h>
        !            19: #include <libxml/xmlIO.h>
        !            20: #include <libxml/list.h>
        !            21: #include <libxml/xmlstring.h>
        !            22: 
        !            23: #ifdef __cplusplus
        !            24: extern "C" {
        !            25: #endif
        !            26: 
        !            27:     typedef struct _xmlTextWriter xmlTextWriter;
        !            28:     typedef xmlTextWriter *xmlTextWriterPtr;
        !            29: 
        !            30: /*
        !            31:  * Constructors & Destructor
        !            32:  */
        !            33:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            34:         xmlNewTextWriter(xmlOutputBufferPtr out);
        !            35:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            36:         xmlNewTextWriterFilename(const char *uri, int compression);
        !            37:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            38:         xmlNewTextWriterMemory(xmlBufferPtr buf, int compression);
        !            39:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            40:         xmlNewTextWriterPushParser(xmlParserCtxtPtr ctxt, int compression);
        !            41:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            42:         xmlNewTextWriterDoc(xmlDocPtr * doc, int compression);
        !            43:     XMLPUBFUN xmlTextWriterPtr XMLCALL
        !            44:         xmlNewTextWriterTree(xmlDocPtr doc, xmlNodePtr node,
        !            45:                              int compression);
        !            46:     XMLPUBFUN void XMLCALL xmlFreeTextWriter(xmlTextWriterPtr writer);
        !            47: 
        !            48: /*
        !            49:  * Functions
        !            50:  */
        !            51: 
        !            52: 
        !            53: /*
        !            54:  * Document
        !            55:  */
        !            56:     XMLPUBFUN int XMLCALL
        !            57:         xmlTextWriterStartDocument(xmlTextWriterPtr writer,
        !            58:                                    const char *version,
        !            59:                                    const char *encoding,
        !            60:                                    const char *standalone);
        !            61:     XMLPUBFUN int XMLCALL xmlTextWriterEndDocument(xmlTextWriterPtr
        !            62:                                                    writer);
        !            63: 
        !            64: /*
        !            65:  * Comments
        !            66:  */
        !            67:     XMLPUBFUN int XMLCALL xmlTextWriterStartComment(xmlTextWriterPtr
        !            68:                                                     writer);
        !            69:     XMLPUBFUN int XMLCALL xmlTextWriterEndComment(xmlTextWriterPtr writer);
        !            70:     XMLPUBFUN int XMLCALL
        !            71:         xmlTextWriterWriteFormatComment(xmlTextWriterPtr writer,
        !            72:                                         const char *format, ...)
        !            73:                                        LIBXML_ATTR_FORMAT(2,3);
        !            74:     XMLPUBFUN int XMLCALL
        !            75:         xmlTextWriterWriteVFormatComment(xmlTextWriterPtr writer,
        !            76:                                          const char *format,
        !            77:                                          va_list argptr)
        !            78:                                         LIBXML_ATTR_FORMAT(2,0);
        !            79:     XMLPUBFUN int XMLCALL xmlTextWriterWriteComment(xmlTextWriterPtr
        !            80:                                                     writer,
        !            81:                                                     const xmlChar *
        !            82:                                                     content);
        !            83: 
        !            84: /*
        !            85:  * Elements
        !            86:  */
        !            87:     XMLPUBFUN int XMLCALL
        !            88:         xmlTextWriterStartElement(xmlTextWriterPtr writer,
        !            89:                                   const xmlChar * name);
        !            90:     XMLPUBFUN int XMLCALL xmlTextWriterStartElementNS(xmlTextWriterPtr
        !            91:                                                       writer,
        !            92:                                                       const xmlChar *
        !            93:                                                       prefix,
        !            94:                                                       const xmlChar * name,
        !            95:                                                       const xmlChar *
        !            96:                                                       namespaceURI);
        !            97:     XMLPUBFUN int XMLCALL xmlTextWriterEndElement(xmlTextWriterPtr writer);
        !            98:     XMLPUBFUN int XMLCALL xmlTextWriterFullEndElement(xmlTextWriterPtr
        !            99:                                                       writer);
        !           100: 
        !           101: /*
        !           102:  * Elements conveniency functions
        !           103:  */
        !           104:     XMLPUBFUN int XMLCALL
        !           105:         xmlTextWriterWriteFormatElement(xmlTextWriterPtr writer,
        !           106:                                         const xmlChar * name,
        !           107:                                         const char *format, ...)
        !           108:                                        LIBXML_ATTR_FORMAT(3,4);
        !           109:     XMLPUBFUN int XMLCALL
        !           110:         xmlTextWriterWriteVFormatElement(xmlTextWriterPtr writer,
        !           111:                                          const xmlChar * name,
        !           112:                                          const char *format,
        !           113:                                          va_list argptr)
        !           114:                                         LIBXML_ATTR_FORMAT(3,0);
        !           115:     XMLPUBFUN int XMLCALL xmlTextWriterWriteElement(xmlTextWriterPtr
        !           116:                                                     writer,
        !           117:                                                     const xmlChar * name,
        !           118:                                                     const xmlChar *
        !           119:                                                     content);
        !           120:     XMLPUBFUN int XMLCALL
        !           121:         xmlTextWriterWriteFormatElementNS(xmlTextWriterPtr writer,
        !           122:                                           const xmlChar * prefix,
        !           123:                                           const xmlChar * name,
        !           124:                                           const xmlChar * namespaceURI,
        !           125:                                           const char *format, ...)
        !           126:                                          LIBXML_ATTR_FORMAT(5,6);
        !           127:     XMLPUBFUN int XMLCALL
        !           128:         xmlTextWriterWriteVFormatElementNS(xmlTextWriterPtr writer,
        !           129:                                            const xmlChar * prefix,
        !           130:                                            const xmlChar * name,
        !           131:                                            const xmlChar * namespaceURI,
        !           132:                                            const char *format,
        !           133:                                            va_list argptr)
        !           134:                                           LIBXML_ATTR_FORMAT(5,0);
        !           135:     XMLPUBFUN int XMLCALL xmlTextWriterWriteElementNS(xmlTextWriterPtr
        !           136:                                                       writer,
        !           137:                                                       const xmlChar *
        !           138:                                                       prefix,
        !           139:                                                       const xmlChar * name,
        !           140:                                                       const xmlChar *
        !           141:                                                       namespaceURI,
        !           142:                                                       const xmlChar *
        !           143:                                                       content);
        !           144: 
        !           145: /*
        !           146:  * Text
        !           147:  */
        !           148:     XMLPUBFUN int XMLCALL
        !           149:         xmlTextWriterWriteFormatRaw(xmlTextWriterPtr writer,
        !           150:                                     const char *format, ...)
        !           151:                                    LIBXML_ATTR_FORMAT(2,3);
        !           152:     XMLPUBFUN int XMLCALL
        !           153:         xmlTextWriterWriteVFormatRaw(xmlTextWriterPtr writer,
        !           154:                                      const char *format, va_list argptr)
        !           155:                                     LIBXML_ATTR_FORMAT(2,0);
        !           156:     XMLPUBFUN int XMLCALL
        !           157:         xmlTextWriterWriteRawLen(xmlTextWriterPtr writer,
        !           158:                                  const xmlChar * content, int len);
        !           159:     XMLPUBFUN int XMLCALL
        !           160:         xmlTextWriterWriteRaw(xmlTextWriterPtr writer,
        !           161:                               const xmlChar * content);
        !           162:     XMLPUBFUN int XMLCALL xmlTextWriterWriteFormatString(xmlTextWriterPtr
        !           163:                                                          writer,
        !           164:                                                          const char
        !           165:                                                          *format, ...)
        !           166:                                                         LIBXML_ATTR_FORMAT(2,3);
        !           167:     XMLPUBFUN int XMLCALL xmlTextWriterWriteVFormatString(xmlTextWriterPtr
        !           168:                                                           writer,
        !           169:                                                           const char
        !           170:                                                           *format,
        !           171:                                                           va_list argptr)
        !           172:                                                          LIBXML_ATTR_FORMAT(2,0);
        !           173:     XMLPUBFUN int XMLCALL xmlTextWriterWriteString(xmlTextWriterPtr writer,
        !           174:                                                    const xmlChar *
        !           175:                                                    content);
        !           176:     XMLPUBFUN int XMLCALL xmlTextWriterWriteBase64(xmlTextWriterPtr writer,
        !           177:                                                    const char *data,
        !           178:                                                    int start, int len);
        !           179:     XMLPUBFUN int XMLCALL xmlTextWriterWriteBinHex(xmlTextWriterPtr writer,
        !           180:                                                    const char *data,
        !           181:                                                    int start, int len);
        !           182: 
        !           183: /*
        !           184:  * Attributes
        !           185:  */
        !           186:     XMLPUBFUN int XMLCALL
        !           187:         xmlTextWriterStartAttribute(xmlTextWriterPtr writer,
        !           188:                                     const xmlChar * name);
        !           189:     XMLPUBFUN int XMLCALL xmlTextWriterStartAttributeNS(xmlTextWriterPtr
        !           190:                                                         writer,
        !           191:                                                         const xmlChar *
        !           192:                                                         prefix,
        !           193:                                                         const xmlChar *
        !           194:                                                         name,
        !           195:                                                         const xmlChar *
        !           196:                                                         namespaceURI);
        !           197:     XMLPUBFUN int XMLCALL xmlTextWriterEndAttribute(xmlTextWriterPtr
        !           198:                                                     writer);
        !           199: 
        !           200: /*
        !           201:  * Attributes conveniency functions
        !           202:  */
        !           203:     XMLPUBFUN int XMLCALL
        !           204:         xmlTextWriterWriteFormatAttribute(xmlTextWriterPtr writer,
        !           205:                                           const xmlChar * name,
        !           206:                                           const char *format, ...)
        !           207:                                          LIBXML_ATTR_FORMAT(3,4);
        !           208:     XMLPUBFUN int XMLCALL
        !           209:         xmlTextWriterWriteVFormatAttribute(xmlTextWriterPtr writer,
        !           210:                                            const xmlChar * name,
        !           211:                                            const char *format,
        !           212:                                            va_list argptr)
        !           213:                                           LIBXML_ATTR_FORMAT(3,0);
        !           214:     XMLPUBFUN int XMLCALL xmlTextWriterWriteAttribute(xmlTextWriterPtr
        !           215:                                                       writer,
        !           216:                                                       const xmlChar * name,
        !           217:                                                       const xmlChar *
        !           218:                                                       content);
        !           219:     XMLPUBFUN int XMLCALL
        !           220:         xmlTextWriterWriteFormatAttributeNS(xmlTextWriterPtr writer,
        !           221:                                             const xmlChar * prefix,
        !           222:                                             const xmlChar * name,
        !           223:                                             const xmlChar * namespaceURI,
        !           224:                                             const char *format, ...)
        !           225:                                            LIBXML_ATTR_FORMAT(5,6);
        !           226:     XMLPUBFUN int XMLCALL
        !           227:         xmlTextWriterWriteVFormatAttributeNS(xmlTextWriterPtr writer,
        !           228:                                              const xmlChar * prefix,
        !           229:                                              const xmlChar * name,
        !           230:                                              const xmlChar * namespaceURI,
        !           231:                                              const char *format,
        !           232:                                              va_list argptr)
        !           233:                                             LIBXML_ATTR_FORMAT(5,0);
        !           234:     XMLPUBFUN int XMLCALL xmlTextWriterWriteAttributeNS(xmlTextWriterPtr
        !           235:                                                         writer,
        !           236:                                                         const xmlChar *
        !           237:                                                         prefix,
        !           238:                                                         const xmlChar *
        !           239:                                                         name,
        !           240:                                                         const xmlChar *
        !           241:                                                         namespaceURI,
        !           242:                                                         const xmlChar *
        !           243:                                                         content);
        !           244: 
        !           245: /*
        !           246:  * PI's
        !           247:  */
        !           248:     XMLPUBFUN int XMLCALL
        !           249:         xmlTextWriterStartPI(xmlTextWriterPtr writer,
        !           250:                              const xmlChar * target);
        !           251:     XMLPUBFUN int XMLCALL xmlTextWriterEndPI(xmlTextWriterPtr writer);
        !           252: 
        !           253: /*
        !           254:  * PI conveniency functions
        !           255:  */
        !           256:     XMLPUBFUN int XMLCALL
        !           257:         xmlTextWriterWriteFormatPI(xmlTextWriterPtr writer,
        !           258:                                    const xmlChar * target,
        !           259:                                    const char *format, ...)
        !           260:                                   LIBXML_ATTR_FORMAT(3,4);
        !           261:     XMLPUBFUN int XMLCALL
        !           262:         xmlTextWriterWriteVFormatPI(xmlTextWriterPtr writer,
        !           263:                                     const xmlChar * target,
        !           264:                                     const char *format, va_list argptr)
        !           265:                                    LIBXML_ATTR_FORMAT(3,0);
        !           266:     XMLPUBFUN int XMLCALL
        !           267:         xmlTextWriterWritePI(xmlTextWriterPtr writer,
        !           268:                              const xmlChar * target,
        !           269:                              const xmlChar * content);
        !           270: 
        !           271: /**
        !           272:  * xmlTextWriterWriteProcessingInstruction:
        !           273:  *
        !           274:  * This macro maps to xmlTextWriterWritePI
        !           275:  */
        !           276: #define xmlTextWriterWriteProcessingInstruction xmlTextWriterWritePI
        !           277: 
        !           278: /*
        !           279:  * CDATA
        !           280:  */
        !           281:     XMLPUBFUN int XMLCALL xmlTextWriterStartCDATA(xmlTextWriterPtr writer);
        !           282:     XMLPUBFUN int XMLCALL xmlTextWriterEndCDATA(xmlTextWriterPtr writer);
        !           283: 
        !           284: /*
        !           285:  * CDATA conveniency functions
        !           286:  */
        !           287:     XMLPUBFUN int XMLCALL
        !           288:         xmlTextWriterWriteFormatCDATA(xmlTextWriterPtr writer,
        !           289:                                       const char *format, ...)
        !           290:                                      LIBXML_ATTR_FORMAT(2,3);
        !           291:     XMLPUBFUN int XMLCALL
        !           292:         xmlTextWriterWriteVFormatCDATA(xmlTextWriterPtr writer,
        !           293:                                        const char *format, va_list argptr)
        !           294:                                       LIBXML_ATTR_FORMAT(2,0);
        !           295:     XMLPUBFUN int XMLCALL
        !           296:         xmlTextWriterWriteCDATA(xmlTextWriterPtr writer,
        !           297:                                 const xmlChar * content);
        !           298: 
        !           299: /*
        !           300:  * DTD
        !           301:  */
        !           302:     XMLPUBFUN int XMLCALL
        !           303:         xmlTextWriterStartDTD(xmlTextWriterPtr writer,
        !           304:                               const xmlChar * name,
        !           305:                               const xmlChar * pubid,
        !           306:                               const xmlChar * sysid);
        !           307:     XMLPUBFUN int XMLCALL xmlTextWriterEndDTD(xmlTextWriterPtr writer);
        !           308: 
        !           309: /*
        !           310:  * DTD conveniency functions
        !           311:  */
        !           312:     XMLPUBFUN int XMLCALL
        !           313:         xmlTextWriterWriteFormatDTD(xmlTextWriterPtr writer,
        !           314:                                     const xmlChar * name,
        !           315:                                     const xmlChar * pubid,
        !           316:                                     const xmlChar * sysid,
        !           317:                                     const char *format, ...)
        !           318:                                    LIBXML_ATTR_FORMAT(5,6);
        !           319:     XMLPUBFUN int XMLCALL
        !           320:         xmlTextWriterWriteVFormatDTD(xmlTextWriterPtr writer,
        !           321:                                      const xmlChar * name,
        !           322:                                      const xmlChar * pubid,
        !           323:                                      const xmlChar * sysid,
        !           324:                                      const char *format, va_list argptr)
        !           325:                                     LIBXML_ATTR_FORMAT(5,0);
        !           326:     XMLPUBFUN int XMLCALL
        !           327:         xmlTextWriterWriteDTD(xmlTextWriterPtr writer,
        !           328:                               const xmlChar * name,
        !           329:                               const xmlChar * pubid,
        !           330:                               const xmlChar * sysid,
        !           331:                               const xmlChar * subset);
        !           332: 
        !           333: /**
        !           334:  * xmlTextWriterWriteDocType:
        !           335:  *
        !           336:  * this macro maps to xmlTextWriterWriteDTD
        !           337:  */
        !           338: #define xmlTextWriterWriteDocType xmlTextWriterWriteDTD
        !           339: 
        !           340: /*
        !           341:  * DTD element definition
        !           342:  */
        !           343:     XMLPUBFUN int XMLCALL
        !           344:         xmlTextWriterStartDTDElement(xmlTextWriterPtr writer,
        !           345:                                      const xmlChar * name);
        !           346:     XMLPUBFUN int XMLCALL xmlTextWriterEndDTDElement(xmlTextWriterPtr
        !           347:                                                      writer);
        !           348: 
        !           349: /*
        !           350:  * DTD element definition conveniency functions
        !           351:  */
        !           352:     XMLPUBFUN int XMLCALL
        !           353:         xmlTextWriterWriteFormatDTDElement(xmlTextWriterPtr writer,
        !           354:                                            const xmlChar * name,
        !           355:                                            const char *format, ...)
        !           356:                                           LIBXML_ATTR_FORMAT(3,4);
        !           357:     XMLPUBFUN int XMLCALL
        !           358:         xmlTextWriterWriteVFormatDTDElement(xmlTextWriterPtr writer,
        !           359:                                             const xmlChar * name,
        !           360:                                             const char *format,
        !           361:                                             va_list argptr)
        !           362:                                            LIBXML_ATTR_FORMAT(3,0);
        !           363:     XMLPUBFUN int XMLCALL xmlTextWriterWriteDTDElement(xmlTextWriterPtr
        !           364:                                                        writer,
        !           365:                                                        const xmlChar *
        !           366:                                                        name,
        !           367:                                                        const xmlChar *
        !           368:                                                        content);
        !           369: 
        !           370: /*
        !           371:  * DTD attribute list definition
        !           372:  */
        !           373:     XMLPUBFUN int XMLCALL
        !           374:         xmlTextWriterStartDTDAttlist(xmlTextWriterPtr writer,
        !           375:                                      const xmlChar * name);
        !           376:     XMLPUBFUN int XMLCALL xmlTextWriterEndDTDAttlist(xmlTextWriterPtr
        !           377:                                                      writer);
        !           378: 
        !           379: /*
        !           380:  * DTD attribute list definition conveniency functions
        !           381:  */
        !           382:     XMLPUBFUN int XMLCALL
        !           383:         xmlTextWriterWriteFormatDTDAttlist(xmlTextWriterPtr writer,
        !           384:                                            const xmlChar * name,
        !           385:                                            const char *format, ...)
        !           386:                                           LIBXML_ATTR_FORMAT(3,4);
        !           387:     XMLPUBFUN int XMLCALL
        !           388:         xmlTextWriterWriteVFormatDTDAttlist(xmlTextWriterPtr writer,
        !           389:                                             const xmlChar * name,
        !           390:                                             const char *format,
        !           391:                                             va_list argptr)
        !           392:                                            LIBXML_ATTR_FORMAT(3,0);
        !           393:     XMLPUBFUN int XMLCALL xmlTextWriterWriteDTDAttlist(xmlTextWriterPtr
        !           394:                                                        writer,
        !           395:                                                        const xmlChar *
        !           396:                                                        name,
        !           397:                                                        const xmlChar *
        !           398:                                                        content);
        !           399: 
        !           400: /*
        !           401:  * DTD entity definition
        !           402:  */
        !           403:     XMLPUBFUN int XMLCALL
        !           404:         xmlTextWriterStartDTDEntity(xmlTextWriterPtr writer,
        !           405:                                     int pe, const xmlChar * name);
        !           406:     XMLPUBFUN int XMLCALL xmlTextWriterEndDTDEntity(xmlTextWriterPtr
        !           407:                                                     writer);
        !           408: 
        !           409: /*
        !           410:  * DTD entity definition conveniency functions
        !           411:  */
        !           412:     XMLPUBFUN int XMLCALL
        !           413:         xmlTextWriterWriteFormatDTDInternalEntity(xmlTextWriterPtr writer,
        !           414:                                                   int pe,
        !           415:                                                   const xmlChar * name,
        !           416:                                                   const char *format, ...)
        !           417:                                                  LIBXML_ATTR_FORMAT(4,5);
        !           418:     XMLPUBFUN int XMLCALL
        !           419:         xmlTextWriterWriteVFormatDTDInternalEntity(xmlTextWriterPtr writer,
        !           420:                                                    int pe,
        !           421:                                                    const xmlChar * name,
        !           422:                                                    const char *format,
        !           423:                                                    va_list argptr)
        !           424:                                                   LIBXML_ATTR_FORMAT(4,0);
        !           425:     XMLPUBFUN int XMLCALL
        !           426:         xmlTextWriterWriteDTDInternalEntity(xmlTextWriterPtr writer,
        !           427:                                             int pe,
        !           428:                                             const xmlChar * name,
        !           429:                                             const xmlChar * content);
        !           430:     XMLPUBFUN int XMLCALL
        !           431:         xmlTextWriterWriteDTDExternalEntity(xmlTextWriterPtr writer,
        !           432:                                             int pe,
        !           433:                                             const xmlChar * name,
        !           434:                                             const xmlChar * pubid,
        !           435:                                             const xmlChar * sysid,
        !           436:                                             const xmlChar * ndataid);
        !           437:     XMLPUBFUN int XMLCALL
        !           438:         xmlTextWriterWriteDTDExternalEntityContents(xmlTextWriterPtr
        !           439:                                                     writer,
        !           440:                                                     const xmlChar * pubid,
        !           441:                                                     const xmlChar * sysid,
        !           442:                                                     const xmlChar *
        !           443:                                                     ndataid);
        !           444:     XMLPUBFUN int XMLCALL xmlTextWriterWriteDTDEntity(xmlTextWriterPtr
        !           445:                                                       writer, int pe,
        !           446:                                                       const xmlChar * name,
        !           447:                                                       const xmlChar *
        !           448:                                                       pubid,
        !           449:                                                       const xmlChar *
        !           450:                                                       sysid,
        !           451:                                                       const xmlChar *
        !           452:                                                       ndataid,
        !           453:                                                       const xmlChar *
        !           454:                                                       content);
        !           455: 
        !           456: /*
        !           457:  * DTD notation definition
        !           458:  */
        !           459:     XMLPUBFUN int XMLCALL
        !           460:         xmlTextWriterWriteDTDNotation(xmlTextWriterPtr writer,
        !           461:                                       const xmlChar * name,
        !           462:                                       const xmlChar * pubid,
        !           463:                                       const xmlChar * sysid);
        !           464: 
        !           465: /*
        !           466:  * Indentation
        !           467:  */
        !           468:     XMLPUBFUN int XMLCALL
        !           469:         xmlTextWriterSetIndent(xmlTextWriterPtr writer, int indent);
        !           470:     XMLPUBFUN int XMLCALL
        !           471:         xmlTextWriterSetIndentString(xmlTextWriterPtr writer,
        !           472:                                      const xmlChar * str);
        !           473: 
        !           474: /*
        !           475:  * misc
        !           476:  */
        !           477:     XMLPUBFUN int XMLCALL xmlTextWriterFlush(xmlTextWriterPtr writer);
        !           478: 
        !           479: #ifdef __cplusplus
        !           480: }
        !           481: #endif
        !           482: 
        !           483: #endif /* LIBXML_WRITER_ENABLED */
        !           484: 
        !           485: #endif                          /* __XML_XMLWRITER_H__ */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>