aview-app 1.0.2

package/aardio/lib/fsys/path.aardio

@@ -0,0 +1,179 @@
+//path 路径函数
+namespace fsys.path;
+
+::Shlwapi := ..raw.loadDll("Shlwapi.dll");
+PathCompactPath = Shlwapi.api("PathCompactPath", "int(pointer hdc, ustring&lpszPath, INT dx)" )
+PathCanonicalize = Shlwapi.api("PathCanonicalize", "int(ustring &dst,ustring src)" )  
+PathCommonPrefix = Shlwapi.api("PathCommonPrefix", "int(ustring,ustring,ustring&)" )
+PathRelativePathTo = Shlwapi.api("PathRelativePathTo", "bool(ustring& pszPath,ustring pszFrom,INT dwAttrFrom,ustring pszTo,INT dwAttrTo)" ); 
+GetShortPathName = ::Kernel32.api("GetShortPathNameW","int(ustring long,ustring&short,int cchBuffer)")
+GetLongPathName = ::Kernel32.api("GetLongPathNameW","int(ustring  short,ustring&long,int cchBuffer)")
+
+cmp = function(path,path2){
+    if(!path || !path2) return -1;
+	return ..string.cmp(canonicalize(path),canonicalize(path2));
+}; 
+
+validName = function(name){
+ 	if( type(name) != "string" ) return;
+ 	var name = ..string.replace(name,"[\/\:\*\?\""\<\>\r\n]",""); 
+ 	name = ..string.replace(name,"@\",""); 
+ 	name = ..string.replace(name,"@|",""); 
+ 	return name;
+};
+
+canonicalize = function(path,lng=true){ 
+	if(!path) error("路径参数不能为空",2)
+	path = ..string.replace(path,'/','\\');
+ 	if( path[#path] == ':' ) path = path + "\";
+ 	if( lng ) path = long(path);
+ 	var ret,cp = PathCanonicalize(0x208/*_MAX_WPATH_BYTES*/,path ); 
+ 	if(ret){ 
+ 		return ( removeBackslash( cp ) );//除分区根目录外保证尾部不为斜杠
+ 	}
+};
+
+ischild = function(dir,path){
+ 	if(!(dir&&path) ) return;
+ 	dir = addBackslash(canonicalize(dir,true));
+ 	path = canonicalize(path,true);
+ 	return path ? ..string.startWith(path,dir,true);
+};
+
+long = function(path){
+	if(!path) error("参数不能为空",2);
+	if( !..io.exist(path) )return ..io.fullpath(path);
+	var len,path = GetLongPathName( ..io.fullpath(path) ,0x208/*_MAX_WPATH_BYTES*/,0x104/*_MAX_PATH*/);
+	if(len) return path
+};
+
+short = function(path){
+	if(!path) error("参数不能为空",2);
+	if(!..string.indexAny(path,"/\")) return path;
+	var len,path = GetShortPathName( ..io.fullpath(path) ,0x208/*_MAX_WPATH_BYTES*/,0x104/*_MAX_PATH*/);
+	if(len)return path;
+};
+
+isDir = function(path){
+	if(!path) return false;
+	if( ..string.indexAny(path,"\/",#path) ) return true;
+	var a = ::Kernel32.GetFileAttributesW(path);
+	return  (a!=-1) && ( a & 0x10/*_FILE_ATTRIBUTE_DIRECTORY*/);
+};
+
+relativeTo = function(from,to,fromAttr,toAttr){
+	if(! (from && to) ) error("请指定正确的参数",2);
+	from = long(from);
+	to = long(to);
+
+	if( fromAttr === null ){
+		fromAttr = 0x10/*_FILE_ATTRIBUTE_DIRECTORY*/;
+		if( ..io.exist( from )  ){
+			if( !isDir(from) ) toAttr = 0;
+		}
+	}
+	if( toAttr === null ){
+		toAttr = 0;
+		if( ( ..io.exist( to ) && isDir(to) ) || eofBackslash(to) ){
+			if( isDir(to)  ) toAttr = 0x10/*_FILE_ATTRIBUTE_DIRECTORY*/
+		} 
+	} 
+	
+	var ok,path = PathRelativePathTo(0x208/*_MAX_WPATH_BYTES*/,from,fromAttr,to,toAttr); 
+	if(ok)return path;
+};
+
+relative = function(path,dir,prefix=true,pathAttr){
+	if(! (path && dir) ) error("请指定正确的参数",2); 
+
+ 	dir = addBackslash(dir);
+ 	var r = relativeTo( dir,path,0x10/*_FILE_ATTRIBUTE_DIRECTORY*/,pathAttr)
+ 	if( !r )
+ 			return ( ! ..string.match( path,"<\a+\:>|<\\\\>" ) ) ? path : null;
+
+ 	if( ..string.startWith(r,".\") ){
+ 		if( prefix ) return ..string.right(r,-2);
+ 		return #r>2?..string.right(r,-3):".";
+ 	}
+ 	if( ..string.startWith(r,"..") || ..string.startWith(r,"\..")){
+ 		if(  cmp(path,dir) ) return;
+ 		return prefix?"\":".";
+ 	}
+ 		
+ 	if( prefix ){
+ 		if( r[1] == '\\'# ) return r;
+ 		return "\" + r;
+ 	}
+ 	if( r[1] == '\\'# ) return ..string.right(r,-2);
+ 	return r;
+};
+
+eofBackslash = function(path){
+	return path ? ( ..string.indexAny(path,"\/",#path) );
+};
+
+removeBackslash = function(path){
+	if(!path) error("路径参数不能为空",2); 
+ 	return ..string.trimright(path,"\/");
+}; 
+ 
+addBackslash = function(path){
+	if(path) return ..io.joinpath(path,"\");
+};
+
+compact = function(path,pix = 300){
+	var re,path = PathCompactPath( ,path,pix)
+	return path;
+}; 
+
+commonPrefix = function(path,path2){
+	var l,p = PathCommonPrefix(canonicalize(path),canonicalize(path2),0x208/*_MAX_WPATH_BYTES*/)
+	if(l) return addBackslash(p);//保证尾部为斜杠
+};
+
+replaceDir = function(path,dir,newDir){ 
+	return  ..io.joinpath(newDir,relative(path,dir) );
+};
+
+replaceFile = function(path,filename){ 
+	if(!path) error("路径参数不能为空",2);
+	path = ..string.trimright(path,"\/")
+	return  ..io.joinpath(..io.splitpath(path).dir,filename);
+};	
+
+full = function(path,root){
+    var abs = ..string.match(path,"^<//>|<\\\\>|<[^\\/\:]+\:>");
+    if( abs ) {
+        if(path[#path]==':'#/*D:*/) path = path + "\";
+    	return path;
+    }
+    if( root ) return  ..io.localpath(path) || ..io.fullpath( ..io.joinpath(root,path) );
+}
+
+append = ..io.joinpath;
+
+
+/**intellisense(fsys.path) 
+long(.(路径) = 转为长路径
+short(.(路径) = 转为短路径\n如果文件不存在,返回空值,\n短文件名指向会因实际文件数变更,所以不能把短路径存入数据库\n\n存在特定文件目录无法获取短路径且返回包含空格的长路径的可能性\n如无必要，不建议使用或依赖此函数，正确使用 process 等可以自动\n转义路径参数中的空格。
+isDir(.(路径) = 如果文件路径存在并且是一个目录,\n或者路径路径以斜杠、反斜杠结束返回真
+cmp(.(路径,比较路径) = 比较两个路径是否指向同一位置,\n任何一个参数为null时返回-1,\n返回值意义与 string.cmp()函数相同,\n路径相同则返回0,注意在条件表达式中为false\n\n更准确的检测相同或不同的路径是否指向同一真实文件,\n应使用fsys.fileInfo函数
+compact(.(文件路径,显示像素宽度) = 截断路径来适合一定数目的像素
+commonPrefix(.(路径,路径2) = 返回两个文件路径的公共前缀目录\n该函数失败保证返回的是一个目录比以斜杠结尾,失败返回null,\n在比较以前自动对路径归一化处理,忽略大小写
+canonicalize(.(路径,是否处理短路径) = 转换为完整路径,\n并对路径进行归一化处理,参数2可选(默认为true),\n扩展和适当置换路径中包含的所有".."和"."\n该函数保证除分区根目录外保证尾部不为斜杠
+eofBackslash(.("文件路径") = 首先替换所有正斜杠为反斜杠\n检测路径尾部是否有反斜杠
+addBackslash(__/*路径*/) = 首先替换所有正斜杠为反斜杠\n如果目录最后面没有反斜杠,则追加反斜杠,\n这个函数实际是调用  io.joinpath(path,"/")
+removeBackslash(__/*路径*/) = 首先转换为完整路径,替换所有正斜杠为反斜杠\n移除路径最后面的反斜杠,并返回新路径以及尾字符\n如果尾字符为反斜杠并已移除,第二个返回值为空字符\n如果是分区号后的反斜杠或路径只有一个反斜杠,第二个返回值为反斜杠
+relativeTo(.(参考路径,目标路径,参考路径属性,目标路径属性) = 自参数@1指定的路径得到一个相对路径指向目标路径\n注意相对路径不一定是子目录,如果是上层目录使用 ../ 表示\n路径属性可为0,或 _FILE_ATTRIBUTE_DIRECTORY,可省略
+relative(.(路径,目录,返回路径是否以斜杠开始) = 将路径转换为指定目录下层的相对路径,\n在比较以前自动对路径归一化处理,忽略大小写\n相同路径则返回空字符串,不是该目录下的路径则返回null\n参数三可选,默认首字符为斜杠
+validName(__/*路径*/) = 检测文件名是否合法,\n返回修正后的合法名称\n传入非字符串参数直接返回空值
+replaceDir(.(路径,根目录,新的根目录) = 将路径转换为参数2指定根目录下的相对路径\n再将其转换为新的根目录下的绝对路径
+replaceFile(.(路径,新文件名) = 替换路径中的文件名部分
+ischild(.(目录,路径) = 检测参数@2指定的路径是否在参数@1指定的目录之下
+full(.(path) = 如果路径是绝对路径则返回该路径（不作任何转换）,\n否则返回null
+full(.(path,root) = 如果path是相对路径，并且不以/、\、~等字符开始,\n则返回io.joinpath(root,path)\n否则转换为绝对路径返回
+end intellisense**/
+
+/**intellisense() 
+fsys.path = 提供文件路径相关函数,\n在导入fsys支持库时将自动导入fsys.path
+end intellisense**/

package/aardio/lib/fsys/remove.aardio

@@ -0,0 +1,31 @@
+//remove 移除操作
+import fsys;
+import fsys.safepath;
+namespace fsys;
+
+class remove {
+	ctor( path ){
+		path = ..fsys.safepath(path);
+		if( ..io.exist(path) ){
+			if(..fsys.isDir(path)){
+				var dirs = {};
+				..fsys.enum( path, "*.*",
+					function(d,f,fullpath){ 
+						if(f)  ..io.remove(fullpath) 
+						else ..table.push(dirs,fullpath);
+					},true
+				);
+				
+				for(i=#dirs;1;-1)::Kernel32.RemoveDirectory(dirs[i]); 
+				if( ::Kernel32.RemoveDirectory(path) ) return true;
+			}
+			else if( ..io.remove(path) ) return true;
+		}
+	
+		return ::Kernel32.MoveFileExB(path,null,4/*_MOVEFILE_DELAY_UNTIL_REBOOT*/);
+	}; 
+}
+
+/**intellisense()
+fsys.remove(__) = 用于移除参数@1指定路径的目录或文件，\n支持 fsys.delete 函数无法删除的畸形路径,\n此函数库不在 fsys 库内需要单独导入
+end intellisense**/

package/aardio/lib/fsys/res.aardio

@@ -0,0 +1,149 @@
+//res 资源文件
+import fsys;
+namespace fsys.res;
+ 
+EnumResourceNames = ::Kernel32.api( "EnumResourceNames", "bool(pointer hModule,ustring type,pointer func,pointer lParam)"); 
+BeginUpdateResource = ::Kernel32.api( "BeginUpdateResource", "pointer(ustring filename,bool delExisting)");
+EndUpdateResource  = ::Kernel32.api( "EndUpdateResource", "bool(pointer hUpdate,bool fDiscard)");
+UpdateResource  = ::Kernel32.api( "UpdateResource", "bool(pointer hUpdate,ustring type,ustring name,WORD lang,string data,INT cb)");
+
+open = function(path,delExisting){
+	path = ..io.exist(path);
+	if(!path) error("错误的文件路径",2);
+	
+	var hUpdate = BeginUpdateResource(path,delExisting);
+	if( hUpdate ) return {
+		update = function(resType,resName,resData,lang=0){
+			if( type(resType) == type.number ) resType = topointer(resType);
+			if( type(resName) == type.number ) resName = topointer(resName);
+			return UpdateResource(hUpdate, resType,resName,lang,resData,#resData);
+		};
+		close = function(fDiscard){
+			return EndUpdateResource( hUpdate,fDiscard)
+		} 
+	}
+}
+
+load = function(path,flags){
+	if( flags === null ) flags = 2/*_LOAD_LIBRARY_AS_DATAFILE*/;
+	return ::Kernel32.LoadLibraryExP( ..io.localpath(path) : path ,,flags );
+}
+
+free = function(module){
+	if(!module) error("参数错误",2)
+	return ::Kernel32.FreeLibrary(module);
+}
+ 
+enum = function( proc,resType = "RES",module ){
+	var freeModule;
+	if( type(module) == type.string ){
+		module = ::Kernel32.LoadLibraryExP( ..io.localpath(module) : module ,,2/*_LOAD_LIBRARY_AS_DATAFILE*/)
+		if( !module) return null,"加载文件失败";
+		freeModule = module;
+	}
+	elseif(!module){
+		module = _HINSTANSE;
+	}
+ 
+	var proc_c = ..raw.tostdcall(
+		function(hModule,stype,name,lParam){
+			return proc( hModule,stype,name,lParam);
+		} ,"bool(pointer hModule,ustring stype,ustring name,pointer lParam)"
+	);
+	resType = makeIntResource(resType) : resType;
+	var ret = EnumResourceNames(module,resType,proc_c )
+	if(freeModule) ::Kernel32.FreeLibrary(freeModule);
+	return ret;
+}
+ 
+makeIntResource = function(name){ 
+	if( type(name) == type.number ) return topointer(name);
+	return name;
+} 
+
+loadRes = function(resName,resType = "RES",module ){
+	resType = makeIntResource(resType);
+	resName = makeIntResource(resName);
+	if(!module) module = _HINSTANSE;
+	
+	var tm = type(module);
+	if( tm == type.pointer ){
+		return ..string.loadBuffer(resName,resType,module);
+	} 
+	elseif( tm == type.string ){
+		module = ::Kernel32.LoadLibraryExP( ..io.localpath(module) : module ,,2/*_LOAD_LIBRARY_AS_DATAFILE*/)
+		if( !module) return null,"加载文件失败";
+		var res = ..string.load(resName,resType,module);
+		::Kernel32.FreeLibrary(module);
+		return res;
+	}  
+} 
+
+saveRes = function(srcDir="/",target="/"){
+
+	srcDir = ..string.upper( ..string.replace(srcDir,"@\","/") );
+	if( srcDir[1] != '/'#)
+		srcDir =  '/' + srcDir;
+	
+	if( _STUDIO_INVOKED ){ 
+		target = ..fsys.joinpath(target , srcDir); 
+		if( ..io.exist(target) ) return;
+		return ..fsys.copy( ..fsys.joinpath(srcDir,"/*"),..fsys.createDir( target )  );  
+	}
+		
+	return enum(
+		function(module,resType,resName){
+			if( ..string.startWith(resName,srcDir) ){
+				var str = ..string.load( resName )
+				var path = ..fsys.joinpath(target,resName)
+				..fsys.createDir( ..fsys.getParentDir(path)  )
+				..string.save( path,str ) 
+			}
+			return true;
+		},"RES"
+	)
+}
+
+saveAppData = function(resDir="/",target){
+    if(#target<6) error("参数@2必须大于6个这符",2)
+    target = ..io.joinpath("/aardio-res/",target);
+	var appdata = ..io.appData( target )
+
+	if( ..fsys.res.saveRes(resDir,appdata) ){
+		return ..io.exist( ..io.joinpath(appdata,resDir) )
+	} 
+}
+
+/**intellisense(fsys.res)
+enum(回调函数,资源类型,模块句柄或路径) =  @.enum(\n	function(module,resType,resName){ \n		var res = string.load(resName,resType,module);\n		return true;\n	}\n)
+saveRes(.(源目录,目标目录) = 保存内嵌资源目录为硬盘文件\n源目录可指定源目录路径\n所有参数可省略
+saveAppData(.(资源目录,目标目录) = 保存内嵌资源目录到系统AppData目录\n源目录可指定源目录路径\n目标目录必须指定子目录路径,不能指定完整路径,\n所有参数可省略
+makeIntResource(__) = 将数值类型资源名转换为指针,字符串类型名直接返回
+load(.("DLL路径") = 加载资源DLL并返回句柄\n仅加载资源不会执行DLL代码\n返回值可作为fsys.res.enum或string.load的最后一个参数\n注意必须调用fsys.res.free函数释放返回的句柄
+free(.(dll句柄) = 释放DLL
+loadRes(.(资源名,资源类型,模块句柄或路径) = 加载资源文件,返回buffer\n除参数@1外的其他参数可省略
+end intellisense**/
+
+/**intellisense()
+fsys.res.open() = !fsys_res_updater.
+!fsys_res_updater.update(.(资源类型,资源名,数据) = 更新或添加资源
+!fsys_res_updater.close(.(是否丢弃更改) = 关闭并更新资源,\n参数可选,默认为false
+fsys.res.open(.(执行文件路径,是否删除旧的资源) = 打开资源准备更新
+end intellisense**/
+
+/**intellisense()
+_RT_ACCELERATOR=@0x9/*_RT_ACCELERATOR*/
+_RT_BITMAP=@0x2/*_RT_BITMAP*/
+_RT_CURSOR=@0x1/*_RT_CURSOR*/
+_RT_DIALOG=@0x5/*_RT_DIALOG*/
+_RT_FONT=@0x8/*_RT_FONT*/
+_RT_FONTDIR=@0x7/*_RT_FONTDIR*/
+_RT_ICON=@0x3/*_RT_ICON*/
+_RT_MENU=@0x4/*_RT_MENU*/
+_RT_RCDATA=@0xA/*_RT_RCDATA*/
+_RT_STRING=@0x6/*_RT_STRING*/
+_RT_TYPELIB=@"TYPELIB"
+_RT_VERSION = @0x10/*_RT_VERSION*/
+_VS_VERSION_INFO = @0x1/*_VS_VERSION_INFO*/
+_RT_GROUP_ICON=@0xE/*_RT_GROUP_ICON*/
+end intellisense**/

package/aardio/lib/fsys/safepath.aardio

@@ -0,0 +1,36 @@
+//safepath 安全路径
+namespace fsys;
+
+class safepath{
+	ctor( path ){
+		if(!path) return;
+		path = ..io.localpath(path) : path;
+		if(path[#path]==':'#/*D:*/) path = path + "\"; 
+	
+		//盘符可能有中文、数值
+		if(..string.find(path,"^<[^\\/\:]+\:>")) { 
+			return "\\?\" + path;//完整路径直接返回
+		}
+		
+		var r = ..io.fullpath(path); 
+		if(..string.find(r,"^<[^\\/\:]+\:>")) {
+			if(path[#path]=='\\'# || path[#path]=='/'# ) return "\\?\" + r;
+			
+			//复原 io.fullpath 尾部自动移除的点号
+			var d,f = ..string.match(r,"(.*?)([^/\\]+)$");
+			var d2,f2 = ..string.match(path,"(.*?)([^/\\]+)$");
+			if(!d && (r[#r]=='\\'# ) && f2 && ..string.find(f2,"^\.+$")){
+				r = r ++ f2;
+			}
+			elseif(d&&f2) r = d ++ f2; 
+			
+			return "\\?\" + r;
+		}
+
+		return r;
+	}; 
+}
+
+/**intellisense()
+fsys.safepath(__) = 参数@1指定的文件路径转换为完整路径返回,\n如果完整路径自盘符开始（例如以 C:\ 开始的路径）则返回路径加上 \\?\ 前缀。\n可用于访问畸形路径
+end intellisense**/

package/aardio/lib/fsys/shortcut.aardio

@@ -0,0 +1,55 @@
+//shortcut 快捷方式生成器
+import fsys.lnk;
+import fsys.url;
+namespace fsys;
+
+class shortcut {
+	ctor( appDir ){ 
+		if( appDir )this.appDir = ..io.fullpath(appDir); 
+	};
+	create = function( param ){
+		return __pin__( param,this.appDir,true);
+	};
+	delete = function( param ){
+		return __pin__( param,this.appDir,false);
+	};
+}
+
+namespace shortcut {
+
+	__pin__ = function( param,appDir,pin ){ 
+    	if( appDir ) {
+    		param = ..table.mix({},param);
+    		if( param.lnk ) param.lnk = ..fsys.joinpath(appDir,param.lnk );
+    		if( param.icon ) param.icon = ..fsys.joinpath(appDir,param.icon );
+    		if( param.workDir ) param.workDir = ..fsys.joinpath(appDir,param.workDir );
+    	}; 
+    	
+    	var lnkFile = param.url  ? ..fsys.url() : ..fsys.lnk();
+    	..table.assign( lnkFile,param );
+    	
+    	if( param.icon ) lnkFile.setIcon(param.icon,param.iconIndex);
+    	if( param.url ) lnkFile.setUrl( param.url,1/*_IURL_SETURL_FL_GUESS_PROTOCOL*/ );
+    	elseif( param.lnk ) lnkFile.path = param.lnk;
+
+    	if( param.programsFolder ) lnkFile.pinToPrograms(pin,param.programsFolder,param.allUsers);
+    	if( param.desktop ) lnkFile.pinToDesktop(pin,param.allUsers);
+    	if( param.startMenu ) lnkFile.pinToStartMenu(pin);
+    	
+    	if( ( !param.url ) && param.lnk ) { 
+    		if( param.taskBar ) lnkFile.pinToTaskbar(pin);
+    		if( param.startMenu ) lnkFile.pinToStartMenu(pin);
+    	}
+	}	
+}
+
+/**intellisense()
+fsys.shortcut = 快捷方式生成器
+fsys.shortcut(.("目标文件根目录" ) = 创建快捷方式生成器\n快捷方式参数可指定相对[目标文件根目录]的子路径
+fsys.shortcut() = !fsys_shortcut.
+end intellisense**/
+ 
+/**intellisense(!fsys_shortcut)
+create( 参数表 ) = @.create( \n    url = "网址";\n    lnk = "应用程序路径";__/*lnk,url必须且只能指定其中一个\n其他参数都是可选的可以省略*/\n    arguments = 启动参数;\n    filename = 快捷方式文件名;\n    icon = 应用程序路径图标或图标资源所在程序路径;\n    iconIndex = 0;  \n    taskBar = true; \n    startMenu = false; \n    desktop = true;\n    programsFolder = "\公司名\"; \n    allUsers = false;\n)
+delete( 参数表 ) = @.delete( \n    url = "网址";\n    lnk = "应用程序路径";__/*lnk,url必须且只能指定其中一个\n其他参数都是可选的可以省略*/\n    filename = "快捷方式文件名";\n    taskBar = true; \n    startMenu = false; \n    desktop = true;\n    programsFolder = "\公司名\"; \n)
+end intellisense**/

package/aardio/lib/fsys/size.aardio

@@ -0,0 +1,39 @@
+//size 文件大小
+namespace fsys.size;
+ 
+GB = 0x40000000;
+MB = 0x100000;
+KB = 0x400;
+bytes = 1;
+  
+unitNames = { 
+    [0x40000000]="GB";[0x100000]="MB";[0x400]="KB";[1]="bytes";
+}
+ 
+format = function(low=0,high=0,unit,precision=2){ 
+	if( low == 0xFFFFFFFF  || high==0xFFFFFFFF) return null,"错误长度";
+	
+	if(!unit){
+		if(high|| low > 0x40000000)
+			unit = 0x40000000;
+		elseif( low > 0x100000 )
+			unit = 0x100000;
+		elseif( low > 0x400 )
+			unit = 0x400;
+		else 
+			unit = 1;
+	} 
+	
+	var size = low/unit;
+	if(high) size = size + high * ( 0xFFFFFFFF /unit) 
+		
+	return ..math.round( size,precision ),unit,unitNames[unit];
+}
+
+/**intellisense(fsys.size)
+GB = 0x40000000;
+MB = 0x100000;
+KB = 0x400;
+bytes = 1;
+format(.(长度,长度高位,单位大小,精度) = 格式化大小,所有参数可选\n默认自动计算最大单位大小,精度默认为最大2位小数\n返回值依次为:大小,单位大小,单位名称\n\n建议改用math.size64实现此函数的功能
+end intellisense**/