<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><meta name="robots" content="noindex"> <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>cpl_string.h Source File</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> </head><body bgcolor="#ffffff"> <!-- Generated by Doxygen 1.2.3-20001105 on Thu Mar 28 09:47:28 2002 --> <center> <a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> <a class="qindex" href="globals.html">File Members</a> <a class="qindex" href="pages.html">Related Pages</a> </center> <hr><h1>cpl_string.h</h1><div class="fragment"><pre>00001 <font class="comment">/**********************************************************************</font> 00002 <font class="comment"> * $Id: cpl_string_h-source.html,v 1.10 2002/04/16 13:11:48 warmerda Exp $</font> 00003 <font class="comment"> *</font> 00004 <font class="comment"> * Name: cpl_string.h</font> 00005 <font class="comment"> * Project: CPL - Common Portability Library</font> 00006 <font class="comment"> * Purpose: String and StringList functions.</font> 00007 <font class="comment"> * Author: Daniel Morissette, danmo@videotron.ca</font> 00008 <font class="comment"> *</font> 00009 <font class="comment"> **********************************************************************</font> 00010 <font class="comment"> * Copyright (c) 1998, Daniel Morissette</font> 00011 <font class="comment"> *</font> 00012 <font class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a</font> 00013 <font class="comment"> * copy of this software and associated documentation files (the "Software"),</font> 00014 <font class="comment"> * to deal in the Software without restriction, including without limitation</font> 00015 <font class="comment"> * the rights to use, copy, modify, merge, publish, distribute, sublicense,</font> 00016 <font class="comment"> * and/or sell copies of the Software, and to permit persons to whom the</font> 00017 <font class="comment"> * Software is furnished to do so, subject to the following conditions:</font> 00018 <font class="comment"> * </font> 00019 <font class="comment"> * The above copyright notice and this permission notice shall be included</font> 00020 <font class="comment"> * in all copies or substantial portions of the Software.</font> 00021 <font class="comment"> * </font> 00022 <font class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</font> 00023 <font class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</font> 00024 <font class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL</font> 00025 <font class="comment"> * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</font> 00026 <font class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING</font> 00027 <font class="comment"> * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER </font> 00028 <font class="comment"> * DEALINGS IN THE SOFTWARE.</font> 00029 <font class="comment"> **********************************************************************</font> 00030 <font class="comment"> *</font> 00031 <font class="comment"> * $Log: cpl_string_h-source.html,v $ 00031 <font class="comment"> * Revision 1.10 2002/04/16 13:11:48 warmerda 00031 <font class="comment"> * updated 00031 <font class="comment"> *</font> 00032 <font class="comment"> * Revision 1.9 2002/03/05 14:26:57 warmerda</font> 00033 <font class="comment"> * expanded tabs</font> 00034 <font class="comment"> *</font> 00035 <font class="comment"> * Revision 1.8 2002/01/16 03:59:28 warmerda</font> 00036 <font class="comment"> * added CPLTokenizeString2</font> 00037 <font class="comment"> *</font> 00038 <font class="comment"> * Revision 1.7 2000/10/06 15:19:03 warmerda</font> 00039 <font class="comment"> * added CPLSetNameValueSeparator</font> 00040 <font class="comment"> *</font> 00041 <font class="comment"> * Revision 1.6 2000/04/26 18:25:10 warmerda</font> 00042 <font class="comment"> * implement CPL_DLL</font> 00043 <font class="comment"> *</font> 00044 <font class="comment"> * Revision 1.5 2000/03/30 05:38:48 warmerda</font> 00045 <font class="comment"> * added CPLParseNameValue</font> 00046 <font class="comment"> *</font> 00047 <font class="comment"> * Revision 1.4 1999/06/26 14:05:19 warmerda</font> 00048 <font class="comment"> * Added CSLFindString().</font> 00049 <font class="comment"> *</font> 00050 <font class="comment"> * Revision 1.3 1999/02/17 01:41:58 warmerda</font> 00051 <font class="comment"> * Added CSLGetField</font> 00052 <font class="comment"> *</font> 00053 <font class="comment"> * Revision 1.2 1998/12/04 21:40:42 danmo</font> 00054 <font class="comment"> * Added more Name=Value manipulation fuctions</font> 00055 <font class="comment"> *</font> 00056 <font class="comment"> * Revision 1.1 1998/12/03 18:26:02 warmerda</font> 00057 <font class="comment"> * New</font> 00058 <font class="comment"> *</font> 00059 <font class="comment"> **********************************************************************/</font> 00060 00061 <font class="preprocessor">#ifndef _CPL_STRING_H_INCLUDED</font> 00062 <font class="preprocessor"></font><font class="preprocessor">#define _CPL_STRING_H_INCLUDED</font> 00063 <font class="preprocessor"></font> 00064 <font class="preprocessor">#include "<a class="code" href="cpl_vsi_h.html">cpl_vsi.h</a>"</font> 00065 <font class="preprocessor">#include "<a class="code" href="cpl_error_h.html">cpl_error.h</a>"</font> 00066 <font class="preprocessor">#include "<a class="code" href="cpl_conv_h.html">cpl_conv.h</a>"</font> 00067 00068 <font class="comment">/*=====================================================================</font> 00069 <font class="comment"> Stringlist functions (strlist.c)</font> 00070 <font class="comment"> =====================================================================*/</font> 00071 CPL_C_START 00072 00073 <font class="keywordtype">char</font> CPL_DLL **CSLAddString(<font class="keywordtype">char</font> **papszStrList, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszNewString); 00074 <font class="keywordtype">int</font> CPL_DLL CSLCount(<font class="keywordtype">char</font> **papszStrList); 00075 <font class="keyword">const</font> <font class="keywordtype">char</font> CPL_DLL *CSLGetField( <font class="keywordtype">char</font> **, <font class="keywordtype">int</font> ); 00076 <font class="keywordtype">void</font> CPL_DLL CSLDestroy(<font class="keywordtype">char</font> **papszStrList); 00077 <font class="keywordtype">char</font> CPL_DLL **CSLDuplicate(<font class="keywordtype">char</font> **papszStrList); 00078 00079 <font class="keywordtype">char</font> CPL_DLL **CSLTokenizeString(<font class="keyword">const</font> <font class="keywordtype">char</font> *pszString ); 00080 <font class="keywordtype">char</font> CPL_DLL **CSLTokenizeStringComplex(<font class="keyword">const</font> <font class="keywordtype">char</font> *pszString, 00081 <font class="keyword">const</font> <font class="keywordtype">char</font> *pszDelimiter, 00082 <font class="keywordtype">int</font> bHonourStrings, <font class="keywordtype">int</font> bAllowEmptyTokens ); 00083 <font class="keywordtype">char</font> CPL_DLL **CSLTokenizeString2( <font class="keyword">const</font> <font class="keywordtype">char</font> *pszString, 00084 <font class="keyword">const</font> <font class="keywordtype">char</font> *pszDelimeter, 00085 <font class="keywordtype">int</font> nCSLTFlags ); 00086 00087 <font class="preprocessor">#define CSLT_HONOURSTRINGS 0x0001</font> 00088 <font class="preprocessor"></font><font class="preprocessor">#define CSLT_ALLOWEMPTYTOKENS 0x0002</font> 00089 <font class="preprocessor"></font><font class="preprocessor">#define CSLT_PRESERVEQUOTES 0x0004</font> 00090 <font class="preprocessor"></font><font class="preprocessor">#define CSLT_PRESERVEESCAPES 0x0008</font> 00091 <font class="preprocessor"></font> 00092 <font class="keywordtype">int</font> CPL_DLL CSLPrint(<font class="keywordtype">char</font> **papszStrList, FILE *fpOut); 00093 <font class="keywordtype">char</font> CPL_DLL **CSLLoad(<font class="keyword">const</font> <font class="keywordtype">char</font> *pszFname); 00094 <font class="keywordtype">int</font> CPL_DLL CSLSave(<font class="keywordtype">char</font> **papszStrList, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszFname); 00095 00096 <font class="keywordtype">char</font> CPL_DLL **CSLInsertStrings(<font class="keywordtype">char</font> **papszStrList, <font class="keywordtype">int</font> nInsertAtLineNo, 00097 <font class="keywordtype">char</font> **papszNewLines); 00098 <font class="keywordtype">char</font> CPL_DLL **CSLInsertString(<font class="keywordtype">char</font> **papszStrList, <font class="keywordtype">int</font> nInsertAtLineNo, 00099 <font class="keywordtype">char</font> *pszNewLine); 00100 <font class="keywordtype">char</font> CPL_DLL **CSLRemoveStrings(<font class="keywordtype">char</font> **papszStrList, <font class="keywordtype">int</font> nFirstLineToDelete, 00101 <font class="keywordtype">int</font> nNumToRemove, <font class="keywordtype">char</font> ***ppapszRetStrings); 00102 <font class="keywordtype">int</font> CPL_DLL CSLFindString( <font class="keywordtype">char</font> **, <font class="keyword">const</font> <font class="keywordtype">char</font> * ); 00103 00104 <font class="keyword">const</font> <font class="keywordtype">char</font> CPL_DLL *CPLSPrintf(<font class="keywordtype">char</font> *fmt, ...); 00105 <font class="keywordtype">char</font> CPL_DLL **CSLAppendPrintf(<font class="keywordtype">char</font> **papszStrList, <font class="keywordtype">char</font> *fmt, ...); 00106 00107 <font class="keyword">const</font> <font class="keywordtype">char</font> CPL_DLL * 00108 CPLParseNameValue(<font class="keyword">const</font> <font class="keywordtype">char</font> *pszNameValue, <font class="keywordtype">char</font> **ppszKey ); 00109 <font class="keyword">const</font> <font class="keywordtype">char</font> CPL_DLL * 00110 CSLFetchNameValue(<font class="keywordtype">char</font> **papszStrList, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszName); 00111 <font class="keywordtype">char</font> CPL_DLL ** 00112 CSLFetchNameValueMultiple(<font class="keywordtype">char</font> **papszStrList, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszName); 00113 <font class="keywordtype">char</font> CPL_DLL ** 00114 CSLAddNameValue(<font class="keywordtype">char</font> **papszStrList, 00115 <font class="keyword">const</font> <font class="keywordtype">char</font> *pszName, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszValue); 00116 <font class="keywordtype">char</font> CPL_DLL ** 00117 CSLSetNameValue(<font class="keywordtype">char</font> **papszStrList, 00118 <font class="keyword">const</font> <font class="keywordtype">char</font> *pszName, <font class="keyword">const</font> <font class="keywordtype">char</font> *pszValue); 00119 <font class="keywordtype">void</font> CPL_DLL CSLSetNameValueSeparator( <font class="keywordtype">char</font> ** papszStrList, 00120 <font class="keyword">const</font> <font class="keywordtype">char</font> *pszSeparator ); 00121 00122 CPL_C_END 00123 00124 <font class="preprocessor">#endif </font><font class="comment">/* _CPL_STRING_H_INCLUDED */</font> </div></pre><hr><address><small>Generated at Thu Mar 28 09:47:28 2002 for GDAL by <a href="http://www.stack.nl/~dimitri/doxygen/index.html"> <img src="doxygen.gif" alt="doxygen" align="middle" border=0 width=110 height=53></a>1.2.3-20001105 written by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>, © 1997-2000</small></address> </body> </html>