tools.h

在UBTUNTU下

//*******************************************************************
// 文 件 名: Tools.h
// 摘    要: 工具类，封装一些常用的函数
// 编    写: [e-mail]
// 日    期: 2004-02-10
// 修    改: 
// Copyright (c) 2004 
//*******************************************************************

#if !defined(AFX_TOOLS_H__C74B5F0D_E1BC_4446_BCC7_2CFA6BF92EFC__INCLUDED_)
#define AFX_TOOLS_H__C74B5F0D_E1BC_4446_BCC7_2CFA6BF92EFC__INCLUDED_

namespace Tools  
{
	//*******************************************************************
	//功能: 拷贝包含在startTag和endTag之间的不包含前后空格的子串
	//输入: szDst--目标缓冲区,iDstSize--目标缓冲区大小,szSrc--源字符串
	//      szStartTag--要查找的开始字符串标记
	//      szEndTag--要查找的结束字符串标记
	//输出: szDst--目标缓冲区
	//返回: true--成功 false--失败
	//*******************************************************************
    bool CopyStrByTag(char *pszDst,
					  int iDstSize,
					  const char *pszSrc,
					  const char *pszStartTag,
					  const char *pszEndTag);

	//*******************************************************************
	//功能: 去掉源字符串前后空格的字符串拷贝
	//输入: szDst--目标缓冲区,szSrc--源字符串
	//输出: szDst--目标缓冲区
	//返回: 目标缓冲区指针,==NULL表示失败
	//*******************************************************************
    char *PureStrcpy(char *szDst,const char *szSrc);

	//*******************************************************************
	//功能: 去掉源字符串前后空格的字符串拷贝
	//输入: szDst--目标缓冲区,szSrc--源字符串,nCount--拷贝的字符串个数
	//输出: szDst--目标缓冲区
	//返回: 目标缓冲区指针,==NULL表示失败
	//*******************************************************************
    char *PureStrncpy(char *szDst,const char *szSrc,unsigned nCount);


	//*******************************************************************
	//功能: 一次创建多级目录
	//输入: szDir--目录字符串
	//输出: 无
	//返回: true--成功 false--失败
	//*******************************************************************
    bool CreateDirectorys(const char *szDir);    

	//*******************************************************************
	//功能: 判断sSub是否是pSrc的开始串,不区分大小写
	//输入: pSrc--源缓冲区,szSub--用于比较的字符串
	//输出: 无
	//返回: true--成功 false--失败
	//*******************************************************************
    bool IStartWith(const void *pSrc,const char *szSub);

	//*******************************************************************
	//功能: 将相对路径的URL转为绝对路径的URL
	//输入: szDstUrl--目标缓冲区,szSrcUrl--源绝对路径URL
	//		szRelaUrl--用于转换的相对路径URL
	//输出: szDstUrl--目标缓冲区
	//返回: 目标缓冲区,==NULL表示失败
	//*******************************************************************
    char *UrlRelaToAbs(char *szDstUrl,
					   const char *szSrcUrl,
					   const char *szRelaUrl);

	//*******************************************************************
	//功能: 将szSrc中包含的所有szSubOld字符串转换成szSubNew,
	//输入: szSrc--需要转换的源字符串
	//		szSubOld--将被替换的旧字符串
	//		szSubNew--将替换成的新字符串
	//输出: 无
	//返回: 如果szSrc中发现szSubOld,返回被替换后的新字符串,新字符串是
	//		在堆分配,使用完后务必delete []！，如果没发现，返回NULL.
	//*******************************************************************
	char *ReplaceAll(const char *szSrc,
					 const char *szSubOld,
					 const char *szSubNew);

	//*******************************************************************
	//功能: 将URL串中的不安全字符编码，现只处理空格情况，假如转换后的URL
	//		长度超过nSrcSize-1,则只保留nSrcSize-1长的URL
	//输入: szUrl--需要编码的URL
	//		nUrlSize--szUrl缓冲区大小
	//输出: 无
	//返回: szUrl
	//*******************************************************************
	char *UrlEncode(char *szUrl,unsigned nUrlSize);

	//*******************************************************************
	//功能: 将数据进行BASE64编码
	//输入: pSrc--源缓冲区,nSrcLen--源缓冲区长度
	//		nMaxLineLen--编码后每行的最大长度
	//输出: pDst--编码后的目标字符串
	//返回: 目标字符串长度
	//*******************************************************************
	int Base64Encode(char* pDst,
					 const unsigned char* pSrc, 
					 int nSrcLen,
					 int nMaxLineLen);

	//*******************************************************************
	//功能: 将BASE64编码数据进行解码
	//输入: pSrc--源缓冲区,nSrcLen--源缓冲区长度
	//输出: pDst--解码后的目标缓冲区
	//返回: 目标缓冲区长度
	//*******************************************************************
	int Base64Decode(unsigned char* pDst,
					 const char* pSrc, 
					 int nSrcLen);

	//*******************************************************************
	//功能: 判断文件是否存在
	//输入: pszFile--文件名
	//输出: 无
	//返回: 真--存在  假--不存在
	//*******************************************************************
	bool IsFile(const char *pszFile);

	//*******************************************************************
	//功能: 判断目录是否存在
	//输入: pszDir --目录名
	//输出: 无
	//返回: 真--存在  假--不存在
	//*******************************************************************
	bool IsDir(const char *pszDir);
};
using namespace Tools;
#endif // !defined(AFX_TOOLS_H__C74B5F0D_E1BC_4446_BCC7_2CFA6BF92EFC__INCLUDED_)