tango.io.vfs.VirtualFolder

License:
BSD style:

Version:
Oct 2007: Initial version

author:
Kris

class VirtualFolder: tango.io.vfs.model.Vfs.VfsHost;
Virtual folders play host to other folder types, including both concrete folder instances and subordinate virtual folders. You can build a (singly rooted) tree from a set of virtual and non- virtual folders, and treat them as though they were a combined or single entity. For example, listing the contents of such a tree is no different than listing the contents of a non-virtual tree - there's just potentially more nodes to traverse.

this(const(char)[] name);
All folder must have a name. No '.' or '/' chars are permitted

final @property const(char)[] name();
Return the (short) name of this folder

final string toString();
Return the (long) name of this folder. Virtual folders do not have long names, since they don't relate directly to a concrete folder instance

VfsHost mount(VfsFolder folder, const(char)[] name = null);
Add a child folder. The child cannot 'overlap' with others in the tree of the same type. Circular references across a tree of virtual folders are detected and trapped.

The second argument represents an optional name that the mount should be known as, instead of the name exposed by the provided folder (it is not an alias).

VfsHost mount(VfsFolders group);
Add a set of child folders. The children cannot 'overlap' with others in the tree of the same type. Circular references are detected and trapped.

VfsHost dismount(VfsFolder folder);
Unhook a child folder

final VfsHost map(VfsFile file, const(char)[] name);
Add a symbolic link to another file. These are referenced by file() alone, and do not show up in tree traversals

final VfsHost map(VfsFolderEntry folder, const(char)[] name);
Add a symbolic link to another folder. These are referenced by folder() alone, and do not show up in tree traversals

final int opApply(scope int delegate(ref VfsFolder) dg);
Iterate over the set of immediate child folders. This is useful for reflecting the hierarchy

final VfsFolderEntry folder(const(char)[] path);
Return a folder representation of the given path. If the path-head does not refer to an immediate child, and does not match a symbolic link, it is considered unknown.

@property VfsFile file(const(char)[] path);
Return a file representation of the given path. If the path-head does not refer to an immediate child folder, and does not match a symbolic link, it is considered unknown.

final VfsFolder clear();
Clear the entire subtree. Use with caution

final @property bool writable();
Returns true if all of the children are writable

final @property VfsFolders self();
Returns a folder set containing only this one. Statistics are inclusive of entries within this folder only, which should be zero since symbolic links are not included

final @property VfsFolders tree();
Returns a subtree of folders. Statistics are inclusive of all files and folders throughout the sub-tree

final void verify(VfsFolder folder, bool mounting);
Sweep the subtree of mountpoints, testing a new folder against all others. This propogates a folder test down throughout the tree, where each folder implementation should take appropriate action

VfsFolder close(bool commit = true);
Close and/or synchronize changes made to this folder. Each driver should take advantage of this as appropriate, perhaps combining multiple files together, or possibly copying to a remote location

package final string error(string msg);
Throw an exception


Page generated by Ddoc. Copyright (c) 2007 Kris Bell. All rights reserved