English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Classes e Métodos de Arquivo do Ruby

File representa uma conexão com um arquivo normal stdio objeto. open retorna um exemplo dessa classe para arquivos normais.

Método de classe

Número de ordemMétodo & Descrição
1File::atime( path)
retorna path o tempo de acesso final.
2File::basename( path[, suffix])
retorna path O nome do arquivo no final. Se especificado sufixoentão ele será removido do final do nome do arquivo.
Por exemplo: File.basename("/home/users/bin/ruby.exe") #=> "ruby.exe"
3File::blockdev?( path)
Se path for um dispositivo de bloco, retorna true.
4File::chardev?( path)
Se path for um dispositivo de caractere, retorna true.
5File::chmod( mode, path...)
Muda o modo de permissão do arquivo especificado.
6File::chown( owner, group, path...)
Muda o proprietário e o grupo do arquivo especificado.
7File::ctime( path)
Retorna o tempo de modificação do último inode de path.
8File::delete( path...)
File::unlink( path...)

Exclui o arquivo especificado.
9File::directory?( path)
Se path for um diretório, retorna true.
10File::dirname( path)
Retorna a parte do diretório de path, sem incluir o nome do arquivo final.
11File::executable?( path)
Se path for executável, retorna true.
12File::executable_real?( path)
Se path for executável com permissões reais do usuário, retorna true.
13File::exist?( path)
Se path existir, retorna true.
1File::expand_path( path[, dir])
Retorna o caminho absoluto de path, onde ~ é o diretório principal do proprietário do processo, ~user é o diretório do usuário. O caminho relativo é relativo ao diretório especificado por dir, se dir for omitido, é relativo ao diretório de trabalho atual.
14File::file?( path)
Retorna true se path for um arquivo comum.
15File::ftype( path)
Retorna uma das seguintes strings, representando o tipo de arquivo:
  • file - Arquivo comum

  • directory - Diretório

  • characterSpecial - Arquivo especial de caractere

  • blockSpecial - Arquivo especial de bloco

  • fifo - Pipe nomeado (FIFO)

  • link - Link simbólico

  • socket - Socket

  • unknown - Tipo de arquivo desconhecido

16File::grpowned?( path)
Retorna true se path for pertencente ao grupo do usuário.
17File::join( item...)
Retorna uma string conectada pelos itens especificados, separados por File::Separator.
Por exemplo: File::join("", "home", "usrs", "bin") # => "/home/usrs/bin"
18File::link( old, new)
Cria um link duro para o arquivo old.
19File::lstat( path)
Igual a stat, mas retorna informações do link simbólico em vez do arquivo apontado.
20File::mtime( path)
Retorna o tempo da última modificação de path.
21File::new( path[, mode="r"])
File::open( path[, mode="r"])
File::open( path[, mode="r"]) {|f| ...}

Abre o arquivo. Se especificado um bloco, executa o bloco passando o novo arquivo como parâmetro. Quando o bloco sair, o arquivo será fechado automaticamente. Esses métodos são diferentes do Kernel.open, mesmo que path comece com |, a string subsequente não será executada como comando.
22File::owned?( path)
Retorna true se path for pertencente a um usuário válido.
23File::pipe?( path)
Retorna true se path for um pipe.
24File::readable?( path)
Retorna true se path for legível.
25File::readable_real?( path)
Retorna true se path for legível com permissões de usuário real.
25File::readlink( path)
Retorna o arquivo apontado por path.
26File::rename( old, new)
Muda o nome do arquivo old para new.
27File::setgid?( path)
Se o set for definido para path-group-Se o bit de permissão de ID estiver definido, retorna true.
28File::setuid?( path)
Se o set for definido para path-user-Se o bit de permissão de ID estiver definido, retorna true.
29File::size( path)
Retorna o tamanho do arquivo path.
30File::size?( path)
Retorna o tamanho do arquivo path, retornando nil se for 0.
31File::socket?( path)
Se o path for um socket, retorna true.
32File::split( path)
Retorna um array contendo o conteúdo do path, dividido em File::dirname(path) e File::basename(path).
33File::stat( path)
Retorna um objeto File::Stat com informações sobre path.
34File::sticky?( path)
Se o bit sticky estiver definido para path, retorna true.
35File::symlink( old, new)
Cria um link simbólico que aponta para o arquivo old.
36File::symlink?( path)
Se o path for um link simbólico, retorna true.
37File::truncate( path, len)
Trunca o arquivo especificado para len bytes.
38File::unlink( path...)
Exclui o arquivo especificado por path.
39File::umask([ mask])
Se nenhum parâmetro for especificado, retorna a umask atual do processo. Se um parâmetro for especificado, define a umask e retorna a umask antiga.
40File::utime( atime, mtime, path...)
Muda o tempo de acesso e modificação do arquivo especificado.
41File::writable?( path)
Se o path for gravável, retorna true.
42File::writable_real?( path)
Se o path for gravável através de permissões de usuário real, retorna true.
43File::zero?( path)
Se o tamanho do arquivo path for 0, retorna true.

Método de exemplo

Supondo f é File Um exemplo de classe:

Número de ordemMétodo & Descrição
1f.atime
Retorna a última hora de acesso do f.
2f.chmode(mode)
Mudar o modo de permissão do f.
3f.chown(owner, group)
Mudar o proprietário e o grupo do f.
4f.ctime
Retornar a última modificação do inode do f.
5f.flock(op)
Chamar flock(2). O op pode ser 0 ou um valor lógico ou os constantes da classe File LOCK_EX, LOCK_NB, LOCK_SH e LOCK_UN.
6Chamar flock(
Igual a stat, mas retorna informações do link simbólico em vez do arquivo apontado.
7f.mtime
Retornar a última modificação do f.
8f.path
Retornar o nome do caminho usado para criar f.
9f.reopen(path[, mode="r"])
Reabrir o arquivo.
10f.truncate(len)
Truncar f para len bytes.