cgiurl.txt

用C些的CGI函数库

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