模块 Find

Find 模块支持自顶向下遍历一组文件路径。

例如，要统计您的主目录下所有文件的大小，并忽略“点”目录中的任何内容（例如，$HOME/.ssh）

require 'find'

total_size = 0

Find.find(ENV["HOME"]) do |path|
  if FileTest.directory?(path)
    if File.basename(path).start_with?('.')
      Find.prune       # Don't look any further into this directory.
    else
      next
    end
  else
    total_size += FileTest.size(path)
  end
end

常量

VERSION

公共类方法

find (*paths, ignore_error: true) { |path| ... }

源

# File lib/find.rb, line 40
def find(*paths, ignore_error: true) # :yield: path
  block_given? or return enum_for(__method__, *paths, ignore_error: ignore_error)

  fs_encoding = Encoding.find("filesystem")

  paths.collect!{|d| raise Errno::ENOENT, d unless File.exist?(d); d.dup}.each do |path|
    path = path.to_path if path.respond_to? :to_path
    enc = path.encoding == Encoding::US_ASCII ? fs_encoding : path.encoding
    ps = [path]
    while file = ps.shift
      catch(:prune) do
        yield file.dup
        begin
          s = File.lstat(file)
        rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
          raise unless ignore_error
          next
        end
        if s.directory? then
          begin
            fs = Dir.children(file, encoding: enc)
          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
            raise unless ignore_error
            next
          end
          fs.sort!
          fs.reverse_each {|f|
            f = File.join(file, f)
            ps.unshift f
          }
        end
      end
    end
  end
  nil
end

使用作为参数列出的每个文件和目录的名称调用关联的块，然后在它们的子目录上递归调用，依此类推。

如果没有给出块，则返回一个枚举器。

有关示例，请参见 Find 模块文档。

prune ()

源

# File lib/find.rb, line 85
def prune
  throw :prune
end

跳过当前文件或目录，并使用下一个条目重新开始循环。如果当前文件是一个目录，则不会递归进入该目录。仅在与 Find::find 关联的块内有意义。

有关示例，请参见 Find 模块文档。

私有实例方法

find (*paths, ignore_error: true) { |path| ... }

源

# File lib/find.rb, line 40
def find(*paths, ignore_error: true) # :yield: path
  block_given? or return enum_for(__method__, *paths, ignore_error: ignore_error)

  fs_encoding = Encoding.find("filesystem")

  paths.collect!{|d| raise Errno::ENOENT, d unless File.exist?(d); d.dup}.each do |path|
    path = path.to_path if path.respond_to? :to_path
    enc = path.encoding == Encoding::US_ASCII ? fs_encoding : path.encoding
    ps = [path]
    while file = ps.shift
      catch(:prune) do
        yield file.dup
        begin
          s = File.lstat(file)
        rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
          raise unless ignore_error
          next
        end
        if s.directory? then
          begin
            fs = Dir.children(file, encoding: enc)
          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
            raise unless ignore_error
            next
          end
          fs.sort!
          fs.reverse_each {|f|
            f = File.join(file, f)
            ps.unshift f
          }
        end
      end
    end
  end
  nil
end

使用作为参数列出的每个文件和目录的名称调用关联的块，然后在它们的子目录上递归调用，依此类推。

如果没有给出块，则返回一个枚举器。

有关示例，请参见 Find 模块文档。

prune ()

源

# File lib/find.rb, line 85
def prune
  throw :prune
end

跳过当前文件或目录，并使用下一个条目重新开始循环。如果当前文件是一个目录，则不会递归进入该目录。仅在与 Find::find 关联的块内有意义。

有关示例，请参见 Find 模块文档。