PathExtensions

修改路径字符串之中的文件名后缀拓展名为newSuffix指定的值。newSuffix不需要添加小数点

Execute file delete

returns a file extension suffix name in lower case.

this is a safe function, which mean the value Nothing will never be returns from this function.

(函数返回文件的拓展名后缀，请注意，这里的返回值是不会带有小数点的)

returns a file extension suffix name in lower case, if there is no extension name or path string is empty, then empty string value will be returned.

Test if is there any given extension name is equals to the extension name of the specific file path.

case ignored

Combine directory path.(这个主要是用于生成文件夹名称)

Example usage

 Dim images As Dictionary(Of String, String) =
     (ls - l - {"*.png", "*.jpg", "*.gif"} <= PlatformEngine.wwwroot.DIR("images")) _
     .ToDictionary(Function(file) file.StripAsId,
                   AddressOf FileName)

Make directory

使用FileSystem.GetFiles()函数枚举 当前的(不是递归的搜索所有的子文件夹)文件夹之中的 所有的符合条件的文件路径

a collection of file full paths

 ls - l - r - pattern <= DIR

的简化拓展函数模式

scan for all sub-folder in recursive mode.

这个函数是会直接枚举出所有的文件路径的

Yield subfolders' FullName

这个函数只会返回文件列表之中的第一个文件，故而需要提取某一个文件夹之中的某一个特定的文件，推荐使用这个函数（这个函数默认只查找第一级文件夹，不会进行递归搜索）

当查找不到目标文件或者文件夹不存在的时候会返回空值

Gets the URL type file path.

(获取URL类型的文件路径)

将目标字符串之中的非法的字符替换为"_"符号以成为正确的文件名字符串。当参数alphabetOnly为真的时候，意味着所有的非字母或者数字的字符都会被替换为下划线，默认为真

假设文件名过长发生在文件名和最后一个文件夹的路径之上

System.IO.PathTooLongException: The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters.

File path illegal?

Gets the file length, if the path is not exists, then returns -1.

(安全的获取文件的大小，如果目标文件不存在的话会返回-1)

Safe file copy operation. (请注意，copyTo参数的字符串最末尾必须是/或者\才会被认作为目录路径)

Check if the target file object is exists on your file system or not. (这个函数也会自动检查目标path参数是否为空)

returns the file path check result:

1. path string is null or empty string: false
2. file not exists: false
3. file is zero length andalso ZERO_Nonexists is config as true: false

Determine that the target directory is exists on the file system or not?

(判断文件夹是否存在)

1. for directory parameter DIR is nothing or empty string: return false

2. for directory not exists: return false

Get the directory its name of the target dir directory

Check if the file is opened by other code?(检测文件是否已经被其他程序打开使用之中)

Gets the name of the target file or directory, if the target is a file, then the name without the extension suffix name.

2017-2-14

原先的函数是依靠系统的API来工作的，故而只能够工作于已经存在的文件之上， 所以在这里为了更加方便的兼容文件夹或者文件路径，在这使用字符串的方法来 进行截取

获取目标文件夹的名称或者文件的不包含拓展名的名称

Gets the name of the file's parent directory, returns value is a name, not path. (获取目标文件的父文件夹的文件夹名称，是名称而非路径)

Returns the directory path value of the parent directory. (这个函数是返回文件夹的路径而非名称，这个函数不依赖于系统的底层API， 因为系统的底层API对于过长的文件名会出错)

this function also could be used for handling of the http url location. 这个函数不依赖于系统的底层API，因为系统的底层API对于过长的文件名会出错

Get the specific file system object its relative path to the application base directory.

(获取相对于本应用程序的目标文件的相对路径(请注意，所生成的相对路径之中的字符串最后是没有文件夹的分隔符\或者/的))

Gets the relative path of file system object pcTo reference to the directory path pcFrom.

(请注意，所生成的相对路径之中的字符串最后是没有文件夹的分隔符\或者/的)

The relative path string of pcTo file object reference to directory pcFrom

Gets the full path of the specific file.

(为了兼容Linux，这个函数会自动替换路径之中的\为/符号)

Check of this given windows file path is in UNC full path style?

Gets the full path of the specific directory.

(这个函数为了兼容linux的文件系统，也会自动的将所有的\替换为/)

Removes the file extension name from the file path.

(去除掉文件的拓展名)

Removes the last \ and / character in a directory path string.

(使用这个函数修剪文件夹路径之中的最后一个分隔符，以方便生成文件名)

返回文件名称.拓展名，对于文件夹路径而言，则是返回文件夹名称

这个函数为单纯的字符串解析函数，不依赖于文件系统的API

进行安全的复制，出现错误不会导致应用程序崩溃，大文件不推荐使用这个函数进行复制