前言

    public class NSFileManager : NSObject
    public class NSFileHandle : NSObject, NSSecureCoding 

• NSFileManager 是 Foundation 框架中用来管理和操作文件、目录等文件系统相关联内容的类。

1、路径操作

    let nfManager = NSFileManager.defaultManager()
        
    let folderUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFolder"))!
    let filerUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFile.txt"))!
        
    let srcUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFile.txt"))!
    let dstUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFolder/testFile.txt"))!
        
    // 创建文件夹
    /*
        public func createDirectoryAtPath(path: String, 
                    withIntermediateDirectories createIntermediates: Bool, 
                                    attributes: [String : AnyObject]?) throws
         
        path：文件夹路径
        createIntermediates：是否连同上一级路径一起创建，NO 并且上一级文件路径不存在时会创建失败。
        attributes：文件夹属性，nil 系统默认属性
    */
        
    try! nfManager.createDirectoryAtPath(folderUrl.path!, withIntermediateDirectories: true, attributes: nil)
        
    // 创建文件
    /*
        func createFileAtPath(path: String, 
                     contents data: NSData?, 
                   attributes attr: [NSObject : AnyObject]?) -> Bool
         
        path：文件路径
        data：文件内容，nil 空
        attr：文件属性，nil 系统默认属性
        Bool：文件创建成功时返回值为 true
    */
        
    let bl1:Bool = nfManager.createFileAtPath(filerUrl.path!, contents: nil, attributes: nil)
        
    // 拷贝文件
    /*
        如果 dstUrl 路径文件已存在，该方法会终止拷贝，并返回 false。
        如果 srcUrl 的最后一部分是符号链接，那么只有链接会被拷贝到新路径。
    */
        
    try! nfManager.copyItemAtPath(srcUrl.path!, toPath: dstUrl.path!)
        
    // 删除文件
    /*
        删除成功或者 url 为 nil 时返回 true，如果发生错误返回 false。如果使用 delegate 终止了删除文件的操作，
        则返回 true，如果使用 delegate 终止了删除目录的操作，则返回 false。
    */

    try! nfManager.removeItemAtPath(dstUrl.path!)
        
    // 移动文件
    /*
        如果 dstUrl 路径文件已存在，该方法会终止移动，并返回 false。如果 srcUrl 的最后一部分是符号链接，
        那么只有链接会被移动到新路径。链接所指向的内容仍然保持在现有的位置。
    */

    try! nfManager.moveItemAtPath(srcUrl.path!, toPath: dstUrl.path!)
        
    // 查找满足指定条件的路径
        
        // 返回其 URL。该方法不但可以获得标准系统目录，还可以用来创建临时路径。
        let url1:NSURL = try! nfManager.URLForDirectory(.DocumentDirectory, 
                                               inDomain: .UserDomainMask, 
                                      appropriateForURL: nil, 
                                                 create: true)

        // 返回所有满足条件的路径列表
        let urlObjs:[NSURL] = nfManager.URLsForDirectory(.DocumentDirectory, inDomains: .UserDomainMask)
        let url2:NSURL = urlObjs[0]
    
    // 查询指定路径下的所有子路径
    
        let urls1:[String]? = nfManager.subpathsAtPath(url1.path!)
        let urls2:[String] = try! nfManager.subpathsOfDirectoryAtPath(url1.path!)
        
    // 浅遍历
    
        // 返回指定目录下的文件、子目录及符号链接的列表
        let contentsDir1:[String] = try! nfManager.contentsOfDirectoryAtPath(url1.path!)
        
        // 返回文件全路径
        /*
            public func contentsOfDirectoryAtURL(url: NSURL, 
                          includingPropertiesForKeys keys: [String]?, 
                                       options mask: NSDirectoryEnumerationOptions) throws -> [NSURL]
             
            返回指定目录下的文件、子目录及符号链接的列表，返回的是文件全路径。
             
            url：要进行搜索的目录路径，该路径不能为指向目标目录的符号链接，如果是可以使用 URLByResolvingSymlinksInPath 进行转换。
            keys：用来传入进行搜索的一些特定条件，包括创建时间，修改时间等。
            mask：SkipsHiddenFiles：表示不遍历隐藏文件，
                SkipsSubdirectoryDescendants：表示不递归到子目录内部，
                SkipsPackageDescendants：表示不递归到包内部。
        */
        
        let contentsDir2:[NSURL] = try! nfManager.contentsOfDirectoryAtURL(url1, 
                                                includingPropertiesForKeys: nil, 
                                                                   options: .SkipsHiddenFiles)

    // 深遍历
    
        // 返回指定目录下的所有文件及其子目录下的所有元素路径
        let enumeratorDir1:NSDirectoryEnumerator = nfManager.enumeratorAtPath(url1.path!)!
    
        // 返回文件全路径
        /*
            func enumeratorAtURL(url: NSURL, 
                  includingPropertiesForKeys keys: [AnyObject]?, 
                                     options mask: NSDirectoryEnumerationOptions, 
                             errorHandler handler: ((NSURL!, NSError!) -> Bool)?) -> NSDirectoryEnumerator?
             
            返回指定目录下的所有文件及其子目录下的所有元素路径，返回的是文件全路径。
             
            url：要进行搜索的目录路径，该路径不能为指向目标目录的符号链接，如果是可以使用 URLByResolvingSymlinksInPath 进行转换。
            keys：用来传入进行搜索的一些特定条件，包括创建时间，修改时间等。
            mask：SkipsHiddenFiles：表示不遍历隐藏文件，
                  SkipsSubdirectoryDescendants：表示不递归到子目录内部，
                  SkipsPackageDescendants：表示不递归到包内部。
        */
            
        let enumeratorDir2:NSDirectoryEnumerator = nfManager.enumeratorAtURL(url1, 
                                                  includingPropertiesForKeys: nil, 
                                                                     options: .SkipsHiddenFiles, 
                                                                errorHandler: nil)!
            
        // 枚举遍历深层遍历
        let dEnu:NSDirectoryEnumerator? = nfManager.enumeratorAtPath(url1.path!)
            
        while let obj:AnyObject? = dEnu?.nextObject() {
            print(obj)
        }

    // 显示路径的本地化名称
    /*
        如果指定的文件或目录不存在，会返回 path 本身。
    */
    let displayName:String = nfManager.displayNameAtPath(url1.path!)
        
    // 获取指定路径的各种属性
    
    let attributes:[String:AnyObject] = try! nfManager.attributesOfItemAtPath(url1.path!)
    
    // 获取指定路径文件的内容数据
    /*
        如果指定路径为目录或发生错误，返回 nil。
    */
    let data:NSData? = nfManager.contentsAtPath(url1.path!.stringByAppendingString("/test.txt"))
        
    // 获取当前路径
    
    let currentPath:String = nfManager.currentDirectoryPath
        
    // 更改当前路径
    /*
        /Users/JHQ0228/Desktop/Debug
    */
    let bl6:Bool = nfManager.changeCurrentDirectoryPath(NSHomeDirectory().stringByAppendingString("/Desktop/Debug"))
        
    // 获取临时工作路径
    /*
        获取系统中可以用来创建临时文件的目录路径名，一定要在完成任务之后将在其中创建的文件删除。
    */
    let tempPath:NSString = NSTemporaryDirectory()
    
    // 获取用户主路径（沙盒路径）
    
    let homePath:NSString = NSHomeDirectory()
        
    // 获取指定用户的主路径
    /*
        NSUserName(); 获取当前用户的登录名。NSFullUserName(); 获取当前用户完整用户名
    */
    let userHomePath:String? = NSHomeDirectoryForUser(NSUserName())
        
    // 获取用户 Documents 路径
    
    let documentPath:NSString = NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true)[0]
        
    // 获取 app 包路径
    
    let bundlePath = NSBundle.mainBundle().bundlePath
        
    // 创建一个新路径
    
    try! nfManager.createDirectoryAtPath(NSHomeDirectory().stringByAppendingString("/Desktop/Debug1"), 
                                                       withIntermediateDirectories: true, attributes: nil)
        
    // 获取最后一个路径
    
    let lastPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?.lastPathComponent
        
    // 删除最后一个路径
    
    let deleteLastPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?
                                                                .URLByDeletingLastPathComponent?
                                                                .path
        
    // 拼接一个路径
    
    let appendingPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?
                                                               .URLByAppendingPathComponent("testFolder")
                                                               .path
        
    // 文件路径分割
    
    let pathArray:[String]? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?.pathComponents
        
    // 文件路径组合
    
    let pathString:NSString = NSString.pathWithComponents(pathArray!)
        
    // 将路径中的代字符 ~ 扩展成用户主目录或指定用户的主目录
    
        // 特殊的代字符 ~ 是用户主目录（如：/Users/JHQ0228）的缩写，~linda 表示用户 linda 主目录的缩写。
        let path1:NSString = "~/Desktop/test.txt";

        // /Users/JHQ0228/Desktop/test.txt
        let mainPath:String = path1.stringByExpandingTildeInPath
        
    // 解析路径中的符号链接
    /*
        /..    上一级目录
    */
    let path2:NSString = "~/../Debug"
    let appPath1:String = path2.stringByResolvingSymlinksInPath
        
    // 通过解析 ~（用户主目录）、..（父目录） 、.（当前目录）和符号链接来标准化路径
    /*
        NSHomeDirectory()/..    NSHomeDirectory() 的上一级目录
    */
    let path3:NSString = NSString(format:"%@/../Debug", NSHomeDirectory())
    let appPath2:String = path3.stringByStandardizingPath
        
    // 获取文件拓展名
    
    let getExtension:String? = NSURL(string: "/Desktop/test.txt")?.pathExtension
        
    // 删除文件拓展名
    
    let deleteExtension:String? = NSURL(string: "/Desktop/test.txt")?.URLByDeletingPathExtension?.pathExtension
        
    // 拼接文件拓展名
    
    let appendingExtension:String? = NSURL(string: "/Desktop/test.txt")?.URLByAppendingPathExtension("doc").path

2、路径判断

    let nfManager = NSFileManager.defaultManager()
    let url1:NSURL = try! nfManager.URLForDirectory(.DocumentDirectory, 
                                           inDomain: .UserDomainMask, 
                                  appropriateForURL: nil, 
                                             create: true)
        
    // 判断路径是否存在
    /*
        如果当前路径以～开头，需使用 NSString 的 stringByExpandingTildeInPath 方法进行处理，否则会返回 false
    */
    
    let bl1:Bool = nfManager.fileExistsAtPath(url1.path!) 
        
    // 判断指定路径是否有可读权限
    
    let bl2:Bool = nfManager.isReadableFileAtPath(url1.path!)
        
    // 判断指定路径是否有可写权限
    
    let bl3:Bool = nfManager.isWritableFileAtPath(url1.path!)
        
    // 判断指定路径是否有可执行权限
    
    let bl4:Bool = nfManager.isExecutableFileAtPath(url1.path!)
        
    // 判断指定路径是否有可删除权限
    
    let bl5:Bool = nfManager.isDeletableFileAtPath(url1.path!)
        
    // 判断两个指定路径的内容是否相同
    
    let bl6:Bool = nfManager.contentsEqualAtPath(url1.path!, 
                                         andPath: url1.path!.stringByAppendingString("/test.txt"))

3、文件操作

    let fileUrl:NSURL = NSFileManager.defaultManager().URLsForDirectory(.DocumentDirectory, 
                                                              inDomains: .UserDomainMask)[0] 
                                                              as! NSURL
        
    // 文件打开
            
        // 读写
        var nfHandle = NSFileHandle(forUpdatingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!
        
        // 只读
        var nfHandle1 = NSFileHandle(forReadingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!
        
        // 只写
        var nfHandle2 = NSFileHandle(forWritingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!
    
    // 文件句柄偏移量
            
        // 获取文件句柄指针的偏移量
        let offSetNum1:UInt64 = nfHandle.offsetInFile
            
        // 将偏移量移到文件末尾，返回移动后的指针偏移量
        let offSetNum2:UInt64 = nfHandle.seekToEndOfFile()
            
        // 将偏移量指向特定的位置
        nfHandle.seekToFileOffset(0)
    
    // 文件读取
        
        // 获取当前文件句柄的可用数据，获取后指针移到文件末尾
        let availableData:NSData = nfHandle.availableData
            
        // 获取从当前指针位置到文件结束的所有数据，获取后指针移到文件末尾
        let data1:NSData = nfHandle.readDataToEndOfFile()
            
        // 获取从当前指针位置开始读取的 length 长度的数据内容，获取后指针移到文件读取到的位置
        let data2:NSData = nfHandle.readDataOfLength(10)
    
    // 文件写入
        
        // 从当前指针位置写入数据到文件
        nfHandle.writeData("你好".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true)!)
        
    // 文件关闭
        
        // 关闭文件
        nfHandle.closeFile()
        
    // 文件比较
        
        let nfManager = NSFileManager.defaultManager()
            
        // 文件路径
        let filePath1:String = NSHomeDirectory().stringByAppendingString("/Desktop/file1.txt")                          
        let filePath2:String = NSHomeDirectory().stringByAppendingString("/Desktop/file2.txt")
            
        nfManager.createFileAtPath(filePath1, 
                          contents: "北京欢迎您".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true), 
                        attributes: nil)
                        
        nfManager.createFileAtPath(filePath2, 
                          contents: "北京欢迎".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true), 
                        attributes: nil)
            
        // 比较两个文件的内容是否相等
        let bl:Bool = nfManager.contentsEqualAtPath(filePath1, andPath: filePath2)