00001 /********************************************************************** 00002 * $Id: cpl_minixml.h,v 1.13 2005/05/13 18:17:48 fwarmerdam Exp $ 00003 * 00004 * Project: CPL - Common Portability Library 00005 * Purpose: Declarations for MiniXML Handler. 00006 * Author: Frank Warmerdam, warmerdam@pobox.com 00007 * 00008 ********************************************************************** 00009 * Copyright (c) 2001, Frank Warmerdam 00010 * 00011 * Permission is hereby granted, free of charge, to any person obtaining a 00012 * copy of this software and associated documentation files (the "Software"), 00013 * to deal in the Software without restriction, including without limitation 00014 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 00015 * and/or sell copies of the Software, and to permit persons to whom the 00016 * Software is furnished to do so, subject to the following conditions: 00017 * 00018 * The above copyright notice and this permission notice shall be included 00019 * in all copies or substantial portions of the Software. 00020 * 00021 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 00022 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 00023 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 00024 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 00025 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 00026 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 00027 * DEALINGS IN THE SOFTWARE. 00028 ********************************************************************** 00029 * 00030 * $Log: cpl_minixml.h,v $ 00031 * Revision 1.13 2005/05/13 18:17:48 fwarmerdam 00032 * added CPLRemoveXMLChild 00033 * 00034 * Revision 1.12 2005/03/09 17:07:25 fwarmerdam 00035 * added CPLSearchXMLNode 00036 * 00037 * Revision 1.11 2004/01/29 15:29:28 warmerda 00038 * Added CPLCleanXMLElementName 00039 * 00040 * Revision 1.10 2003/12/04 15:46:51 warmerda 00041 * Added CPLAddXMLSibling() 00042 * 00043 * Revision 1.9 2003/11/05 20:14:21 warmerda 00044 * added lots of documentation 00045 * 00046 * Revision 1.8 2003/03/27 18:12:41 warmerda 00047 * Added NULL pszNameSpace support in namespace stripper (all namespaces). 00048 * Added XML file read/write functions. 00049 * 00050 * Revision 1.7 2003/03/24 16:46:48 warmerda 00051 * added CPLStripXMLNamespace 00052 * 00053 * Revision 1.6 2002/11/16 20:38:34 warmerda 00054 * added support for literals like DOCTYPE 00055 * 00056 * Revision 1.5 2002/05/24 04:09:10 warmerda 00057 * added clone and SetXMLValue functions 00058 * 00059 * Revision 1.4 2002/03/05 14:26:57 warmerda 00060 * expanded tabs 00061 * 00062 * Revision 1.3 2002/01/23 20:45:06 warmerda 00063 * handle <?...?> and comment elements 00064 * 00065 * Revision 1.2 2001/12/06 18:13:49 warmerda 00066 * added CPLAddXMLChild and CPLCreateElmentAndValue 00067 * 00068 * Revision 1.1 2001/11/16 15:39:48 warmerda 00069 * New 00070 * 00071 **********************************************************************/ 00072 00073 #ifndef _CPL_MINIXML_H_INCLUDED 00074 #define _CPL_MINIXML_H_INCLUDED 00075 00076 #include "cpl_port.h" 00077 00084 CPL_C_START 00085 00086 typedef enum 00087 { CXT_Element = 0, CXT_Text = 1, CXT_Attribute = 2, CXT_Comment = 3, CXT_Literal = 4 00093 } CPLXMLNodeType; 00094 00108 typedef struct _CPLXMLNode 00109 { 00116 CPLXMLNodeType eType; 00117 00139 char *pszValue; 00140 00148 struct _CPLXMLNode *psNext; 00149 00160 struct _CPLXMLNode *psChild; 00161 } CPLXMLNode; 00162 00163 00164 CPLXMLNode CPL_DLL *CPLParseXMLString( const char * ); 00165 void CPL_DLL CPLDestroyXMLNode( CPLXMLNode * ); 00166 CPLXMLNode CPL_DLL *CPLGetXMLNode( CPLXMLNode *poRoot, 00167 const char *pszPath ); 00168 CPLXMLNode CPL_DLL *CPLSearchXMLNode( CPLXMLNode *poRoot, 00169 const char *pszTarget ); 00170 const char CPL_DLL *CPLGetXMLValue( CPLXMLNode *poRoot, 00171 const char *pszPath, 00172 const char *pszDefault ); 00173 CPLXMLNode CPL_DLL *CPLCreateXMLNode( CPLXMLNode *poParent, 00174 CPLXMLNodeType eType, 00175 const char *pszText ); 00176 char CPL_DLL *CPLSerializeXMLTree( CPLXMLNode *psNode ); 00177 void CPL_DLL CPLAddXMLChild( CPLXMLNode *psParent, 00178 CPLXMLNode *psChild ); 00179 int CPL_DLL CPLRemoveXMLChild( CPLXMLNode *psParent, 00180 CPLXMLNode *psChild ); 00181 void CPL_DLL CPLAddXMLSibling( CPLXMLNode *psOlderSibling, 00182 CPLXMLNode *psNewSibling ); 00183 CPLXMLNode CPL_DLL *CPLCreateXMLElementAndValue( CPLXMLNode *psParent, 00184 const char *pszName, 00185 const char *pszValue ); 00186 CPLXMLNode CPL_DLL *CPLCloneXMLTree( CPLXMLNode *psTree ); 00187 int CPL_DLL CPLSetXMLValue( CPLXMLNode *psRoot, const char *pszPath, 00188 const char *pszValue ); 00189 void CPL_DLL CPLStripXMLNamespace( CPLXMLNode *psRoot, 00190 const char *pszNameSpace, 00191 int bRecurse ); 00192 void CPL_DLL CPLCleanXMLElementName( char * ); 00193 00194 CPLXMLNode CPL_DLL *CPLParseXMLFile( const char *pszFilename ); 00195 int CPL_DLL CPLSerializeXMLTreeToFile( CPLXMLNode *psTree, 00196 const char *pszFilename ); 00197 00198 CPL_C_END 00199 00200 #endif /* _CPL_MINIXML_H_INCLUDED */