eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'UnixFilename':
Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: UnixFilename

Inheritance:

   Object
   |
   +--Filename
      |
      +--UnixFilename
Package:
stx:libbasic
Category:
OS-Unix
Version:
rev: 1.28 date: 2017/09/21 09:13:48
user: stefan
file: UnixFilename.st directory: libbasic
module: stx stc-classLibrary: libbasic

Description:


Filenames in Unix.

Class protocol:

defaults
o  defaultTempDirectoryName
return the default temp directory as a filename.
usage example(s): 
     Filename defaultTempDirectoryName
     Filename defaultTempDirectoryName exists
     Filename defaultTempDirectoryName isWritable

queries
o  isBadCharacter: aCharacter
return true, if aCharacter is unallowed in a filename.

o  isCaseSensitive
return true, if filenames are case sensitive.
This is not really correct, as the sensitivity may depend on
the paricular mounted file system (NFS, for example)

o  nullFilename
Return /dev/null
usage example(s): 
     Filename nullFilename

o  parentDirectoryName
return the name used for the parent directory.
This is '..' for unix and dos-like systems.
(there may be more in the future.

o  separator
return the file/directory separator.
usage example(s): 
      Filename concreteClass separator

o  separatorString
return the file/directory separator as a string.
usage example(s): 
     Filename separatorString

Instance protocol:

file queries
o  fileType
this returns a string describing the type of contents of the file.
This is done using the unix 'file' command,
(which usually is configurable by /etc/magic).
Warning:
Since the returned string differs among systems (and language settings),
it is only useful for user-information;
NOT as a tag to be used by a program.
For this, use mimeType or mimeTypeOfContents.
usage example(s): 
ones are checked first, using the general fileType implementation.
usage example(s): 
     'Makefile' asFilename fileType 
     '.' asFilename fileType     
     '/dev/null' asFilename fileType        
     'smalltalk.rc' asFilename fileType    
     'bitmaps/SBrowser.xbm' asFilename fileType    
     '../../libtool/bitmaps/SBrowser.xbm' asFilename fileType    
     './stx' asFilename fileType

queries
o  isExplicitRelative
return true, if this name is an explicit relative name
(i.e. starts with './' or '../', to avoid path-prepending)

o  isHidden
return true, if the receiver represents a hidden file.
On UNIX, a name starting with a period is considered hidden.

o  isImplicit
return true, if the receiver represents builtin names such as '.' or '..'.
On UNIX, the current and parent dir names are considered implicit.

special accessing
o  osName
redefined from superclass, because we do not distinguish file and directory names

Examples:


(self named:'/tmp/äöü') writeStream close

ST/X 7.1.0.0; WebServer 1.663 at exept.de:8081; Mon, 04 Aug 2025 14:23:32 GMT