00001 /********************************************************************** 00002 * $Id: cpl_minixml.h,v 1.12 2005/03/09 17:07:25 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.12 2005/03/09 17:07:25 fwarmerdam 00032 * added CPLSearchXMLNode 00033 * 00034 * Revision 1.11 2004/01/29 15:29:28 warmerda 00035 * Added CPLCleanXMLElementName 00036 * 00037 * Revision 1.10 2003/12/04 15:46:51 warmerda 00038 * Added CPLAddXMLSibling() 00039 * 00040 * Revision 1.9 2003/11/05 20:14:21 warmerda 00041 * added lots of documentation 00042 * 00043 * Revision 1.8 2003/03/27 18:12:41 warmerda 00044 * Added NULL pszNameSpace support in namespace stripper (all namespaces). 00045 * Added XML file read/write functions. 00046 * 00047 * Revision 1.7 2003/03/24 16:46:48 warmerda 00048 * added CPLStripXMLNamespace 00049 * 00050 * Revision 1.6 2002/11/16 20:38:34 warmerda 00051 * added support for literals like DOCTYPE 00052 * 00053 * Revision 1.5 2002/05/24 04:09:10 warmerda 00054 * added clone and SetXMLValue functions 00055 * 00056 * Revision 1.4 2002/03/05 14:26:57 warmerda 00057 * expanded tabs 00058 * 00059 * Revision 1.3 2002/01/23 20:45:06 warmerda 00060 * handle <?...?> and comment elements 00061 * 00062 * Revision 1.2 2001/12/06 18:13:49 warmerda 00063 * added CPLAddXMLChild and CPLCreateElmentAndValue 00064 * 00065 * Revision 1.1 2001/11/16 15:39:48 warmerda 00066 * New 00067 * 00068 **********************************************************************/ 00069 00070 #ifndef _CPL_MINIXML_H_INCLUDED 00071 #define _CPL_MINIXML_H_INCLUDED 00072 00073 #include "cpl_port.h" 00074 00081 CPL_C_START 00082 00083 typedef enum 00084 { CXT_Element = 0, CXT_Text = 1, CXT_Attribute = 2, CXT_Comment = 3, CXT_Literal = 4 00090 } CPLXMLNodeType; 00091 00105 typedef struct _CPLXMLNode 00106 { 00113 CPLXMLNodeType eType; 00114 00136 char *pszValue; 00137 00145 struct _CPLXMLNode *psNext; 00146 00157 struct _CPLXMLNode *psChild; 00158 } CPLXMLNode; 00159 00160 00161 CPLXMLNode CPL_DLL *CPLParseXMLString( const char * ); 00162 void CPL_DLL CPLDestroyXMLNode( CPLXMLNode * ); 00163 CPLXMLNode CPL_DLL *CPLGetXMLNode( CPLXMLNode *poRoot, 00164 const char *pszPath ); 00165 CPLXMLNode CPL_DLL *CPLSearchXMLNode( CPLXMLNode *poRoot, 00166 const char *pszTarget ); 00167 const char CPL_DLL *CPLGetXMLValue( CPLXMLNode *poRoot, 00168 const char *pszPath, 00169 const char *pszDefault ); 00170 CPLXMLNode CPL_DLL *CPLCreateXMLNode( CPLXMLNode *poParent, 00171 CPLXMLNodeType eType, 00172 const char *pszText ); 00173 char CPL_DLL *CPLSerializeXMLTree( CPLXMLNode *psNode ); 00174 void CPL_DLL CPLAddXMLChild( CPLXMLNode *psParent, 00175 CPLXMLNode *psChild ); 00176 void CPL_DLL CPLAddXMLSibling( CPLXMLNode *psOlderSibling, 00177 CPLXMLNode *psNewSibling ); 00178 CPLXMLNode CPL_DLL *CPLCreateXMLElementAndValue( CPLXMLNode *psParent, 00179 const char *pszName, 00180 const char *pszValue ); 00181 CPLXMLNode CPL_DLL *CPLCloneXMLTree( CPLXMLNode *psTree ); 00182 int CPL_DLL CPLSetXMLValue( CPLXMLNode *psRoot, const char *pszPath, 00183 const char *pszValue ); 00184 void CPL_DLL CPLStripXMLNamespace( CPLXMLNode *psRoot, 00185 const char *pszNameSpace, 00186 int bRecurse ); 00187 void CPL_DLL CPLCleanXMLElementName( char * ); 00188 00189 CPLXMLNode CPL_DLL *CPLParseXMLFile( const char *pszFilename ); 00190 int CPL_DLL CPLSerializeXMLTreeToFile( CPLXMLNode *psTree, 00191 const char *pszFilename ); 00192 00193 CPL_C_END 00194 00195 #endif /* _CPL_MINIXML_H_INCLUDED */