Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Extra methods, and redefined methods, for the File class on MS Windows

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


== Description
  Additional methods for the File class on MS Windows. Plus, several existing
  methods have been redefined to make them work properly on MS Windows.

== Prerequisites
  * win32-file-stat

== Installation
  gem install win32-file

== Synopsis
  require 'win32/file'

  p File.long_path("C:/Progra~1")       # => C:\Program Files
  p File.short_path("C:/Program Files") # => C:\Progra~1

  # See redefined methods below

== Singleton Methods Added
  * File.long_path
  * File.short_path

== Singleton Methods Redefined
  * File.basename         # UNC path issues, root path differences.
  * File.blksize          # Not implemented in MRI
  * File.blockdev?        # Not implemented in MRI
  * File.chardev?         # Not implemented in MRI
  *       # Better wide character string handling than MRI
  * File.dirname          # UNC path issues in MRI
  * File.executable?      # Not implemented in MRI
  * File.file?            # Handles non-regular files better than MRI
  * File.ftype            # Handles non-regular files better than MRI
  * File.join             # For uniform handling of path separators.
  * File.grpowned?        # Not implemented in MRI
  * File.lstat            # Not implemented in MRI
  * File.owned?           # Not implemented in MRI
  * File.pipe?            # Not implemented in MRI
  * File.readable?        # Not implemented in MRI
  * File.realpath         # MRI doesn't handle symlinks
  * File.realdirpath      # MRI doesn't handle symlinks
  * File.socket?          # Not implemented in MRI
  * File.readlink         # Not implemented in MRI
  * File.split            # UNC path issues in MRI
  * File.stat             # Uses object returned by win32-file-stat
  * File.symlink          # Not implemented in MRI
  * File.symlink?         # Not implemented in MRI
  * File.writable?        # Not implemented in MRI
  * File.world_writable?  # Not implemented in MRI

== Known issues or bugs
  The File.exist? method will return true on stale symlinks.

  Please report any other issues you find on the github page at:

== License
  Artistic 2.0

== Copyright
  (C) 2003-2014, Daniel J. Berger, All Rights Reserved

== Warranty
  This package is provided "as is" and without any express or
  implied warranties, including, without limitation, the implied
  warranties of merchantability and fitness for a particular purpose.

== Authors
  * Daniel J. Berger
  * Park Heesob
Something went wrong with that request. Please try again.