CGIUrl函數子庫文檔
作者：		BetonArmEE
最新版本：	2007-04-24	v1.0

>>> 目錄
1.關于
	1.1.功能概述
	1.2.兼容平臺列表
	1.3.版本歷史
2.知識手冊
	2.1.Url編碼
3.使用指南
	3.1.Url編碼解碼
4.參考列表
	4.1.函數列表

>>> 正文
1.關于

	1.1.功能概述
	
		CGIUrl提供了原始的url編碼解碼功能。
		
	1.2.兼容平臺列表
	
		Windows、UNIX、Linux
		
	1.3.版本歷史
	
		2005-05-02	創建 第一版
		2007-04-16	創建 文檔
		
2.知識手冊

	2.1.Url編碼
	
		（暫參考網上相關資料）
	
3.使用指南

	3.1.Url編碼解碼
	
		以下代碼片斷聲明對緩沖區內的數據進行了Base64編碼：
			char	acBuffer[1024] ;
			BOOL	bret ;
			memset( acBuffer , 0x00 , sizeof(acBuffer) );
			strcpy( acBuffer , "http://www.xxx.com/userinfo.fcsp?nickname=呵呵" );
			bret = CGIUrlEncode(acBuffer) ;
			
.參考列表

	4.1.函數列表
	
		BOOL CGIUrlEncode( char *url );
		BOOL CGIUrlEncodeSafely( char **url , long *url_size );
		
		BOOL CGIUrlDecode( char *url );
				
		·CGIUrlEncode
		Url編碼
		
		函數原型：
			BOOL CGIUrlEncode( char *url );
		輸入參數：
			char *url				url緩沖區
		輸出函數：
			char *url				url緩沖區
		返回值：
			BOOL					成功，返回 TRUE
									失敗，返回 FALSE
		
		詳細描述與注意事項：
			（無）
		示例代碼：
			char	url[ 1024 ] ;
			strcpy( url , "http://www.163.com/userinfo.jsp?username=大傻" );
			bret = CGIUrlEncode( url ) ;
		相關函數：
			CGIUrlEncodeSafely , CGIUrlDecode

		·CGIUrlEncodeSafely
		安全Url編碼
		
		函數原型：
			BOOL CGIUrlEncodeSafely( char *url );
		輸入參數：
			char *url				url緩沖區
			long *url_size			url緩沖區最大大小
		輸出函數：
			char *url				url緩沖區
			long *url_size			url緩沖區最大大小
		返回值：
			BOOL					成功，返回 TRUE
									失敗，返回 FALSE
		
		詳細描述與注意事項：
			（無）
		示例代碼：
			char	url[ 1024 ] ;
			long	size = 1024 ;
			strcpy( url , "http://www.163.com/userinfo.jsp?username=大傻" , &size );
			bret = CGIUrlEncodeSafely( url ) ;
		相關函數：
			CGIUrlEncode , CGIUrlDecode

		·CGIUrlDecode
		Url解碼
		
		函數原型：
			BOOL CGIUrlDecode( char *url );
		輸入參數：
			char *url				url緩沖區
		輸出函數：
			char *url				url緩沖區
		返回值：
			BOOL					成功，返回 TRUE
									失敗，返回 FALSE
		
		詳細描述與注意事項：
			（無）
		示例代碼：
			char	url[ 1024 ] ;
			strcpy( url , "http://www.163.com/userinfo.jsp?username=B4F3C9B5" );
			bret = CGIUrlDecode( url ) ;
		相關函數：
			CGIUrlDecode