diff -uNr dmd-0.102/dmd/html/d/acknowledgements.html dmd-0.103/dmd/html/d/acknowledgements.html --- dmd-0.102/dmd/html/d/acknowledgements.html 2004-09-01 11:18:58.000000000 +0200 +++ dmd-0.103/dmd/html/d/acknowledgements.html 2004-10-20 10:00:10.000000000 +0200 @@ -24,6 +24,7 @@ Hauke Duden, Bruce Eckel, Eric Engstrom, + Dave Fladebo, David Friedman, Stewart Gordon, Ben Hinkle, diff -uNr dmd-0.102/dmd/html/d/changelog.html dmd-0.103/dmd/html/d/changelog.html --- dmd-0.102/dmd/html/d/changelog.html 2004-09-20 23:38:38.000000000 +0200 +++ dmd-0.103/dmd/html/d/changelog.html 2004-10-20 09:59:42.000000000 +0200 @@ -24,6 +24,7 @@

What's new for D 0.103
What's new for D 0.102
What's new for D 0.101
What's new for D 0.100 @@ -84,6 +85,26 @@

What's New for D 0.103

+ +Oct 20, 2004 + +

New/Changed Features

Improved symbolic debug info generation for Win32. +
Added Dwarf2 line number debug info for linux. +
Added Dave Fladebo's speedups to associative arrays. +

+ +

Bugs Fixed

Removed redundant declaration of MAP_FAILED from Phobos. +
Fixed codegen scheduling bug. +
Incorporated Dave Fladebo's linux phobos makefile improvements. +
Incorporated David Friedman's std.thread pause fix. +

+ +

What's New for D 0.102

Sep 20, 2004 @@ -91,7 +112,7 @@

New/Changed Features

Upgraded etc.c.zlib to 1.2.1 (thanks to Sean Kelly). -
Improved performance of array append (thanks to davejf). +
Improved performance of array append (thanks to Dave Fladebo).
Added \dmd\bin\make.exe.
Improved Phobos makefiles.

@@ -99,7 +120,7 @@

Bugs Fixed

Fixed private module construction order. -
Folded in davejf's fix to std.zlib. +
Folded in Dave Fladebo's fix to std.zlib.
Fixed array append seg fault under linux.
Fixed problem where COMDATs could not exist in multiple modules.

Fixed seg fault on const fields as lvalues. diff -uNr dmd-0.102/dmd/html/d/cppstrings.html dmd-0.103/dmd/html/d/cppstrings.html --- dmd-0.102/dmd/html/d/cppstrings.html 2004-09-01 11:20:04.000000000 +0200 +++ dmd-0.103/dmd/html/d/cppstrings.html 2004-10-09 12:49:20.000000000 +0200 @@ -10,7 +10,7 @@ [Search] [D] -
Last update Sep 10, 2003 +
Last update Oct 9, 2004

D Strings vs C++ Strings

@@ -378,7 +378,83 @@ wccpp2 alice30.txt >log 0.1012 +

+ + The following tests were run on linux, again comparing a D compiler + (gdc) + and a C++ compiler (g++) that share a common optimizer and + code generator. The system is Pentium III 800MHz running RedHat Linux 8.0 + and gcc 3.4.2. + The Digital Mars D compiler for linux (dmd) + is included for comparison. +

+ + + + + + + +
Program + Compile + Compile Time + Run + Run Time +
D wc + gdc -O2 -frelease -o wc wc.d + 0.326 + wc alice30.txt > /dev/null + 0.041 +
D wc + dmd wc -O -release + 0.235 + wc alice30.txt > /dev/null + 0.041 +
C++ wccpp1 + g++ -O2 -o wccpp1 wccpp1.cc + 2.874 + wccpp1 alice30.txt > /dev/null + 0.086 +
C++ wccpp2 + g++ -O2 -o wccpp2 wccpp2.cc + 2.886 + wccpp2 alice30.txt > /dev/null + 0.095 +
+

Program +	Compile +	Compile Time +	Run +	Run Time +
D wc +	gdc -O2 -frelease -o wc wc.d +	0.326 +	wc alice30.txt > /dev/null +	0.041 +
D wc +	dmd wc -O -release +	0.235 +	wc alice30.txt > /dev/null +	0.041 +
C++ wccpp1 +	g++ -O2 -o wccpp1 wccpp1.cc +	2.874 +	wccpp1 alice30.txt > /dev/null +	0.086 +
C++ wccpp2 +	g++ -O2 -o wccpp2 wccpp2.cc +	2.886 +	wccpp2 alice30.txt > /dev/null +	0.095 +

+ + These tests compare gdc with g++ on a PowerMac G5 2x2.0GHz + running MacOS X 10.3.5 and gcc 3.4.2. (Timings are a little + less accurate.) +

+ + + + + + +
Program + Compile + Compile Time + Run + Run Time +
D wc + gdc -O2 -frelease -o wc wc.d + 0.28 + wc alice30.txt > /dev/null + 0.03 +
C++ wccpp1 + g++ -O2 -o wccpp1 wccpp1.cc + 1.90 + wccpp1 alice30.txt > /dev/null + 0.07 +
C++ wccpp2 + g++ -O2 -o wccpp2 wccpp2.cc + 1.88 + wccpp2 alice30.txt > /dev/null + 0.08 +

Program +	Compile +	Compile Time +	Run +	Run Time +
D wc +	gdc -O2 -frelease -o wc wc.d +	0.28 +	wc alice30.txt > /dev/null +	0.03 +
C++ wccpp1 +	g++ -O2 -o wccpp1 wccpp1.cc +	1.90 +	wccpp1 alice30.txt > /dev/null +	0.07 +
C++ wccpp2 +	g++ -O2 -o wccpp2 wccpp2.cc +	1.88 +	wccpp2 alice30.txt > /dev/null +	0.08 +

wccpp2 by Allan Odgaard

@@ -445,7 +521,7 @@ target="_top" title="Wiki 4 D">feedback and comments regarding this page. -

diff -uNr dmd-0.102/dmd/html/d/lex.html dmd-0.103/dmd/html/d/lex.html --- dmd-0.102/dmd/html/d/lex.html 2004-09-01 18:04:54.000000000 +0200 +++ dmd-0.103/dmd/html/d/lex.html 2004-09-30 08:31:10.000000000 +0200 @@ -10,7 +10,7 @@ [Search] [D] -
Last update Aug 3, 2004 +
Last update Sep 30, 2004

Lexical

@@ -639,14 +639,14 @@ case cast catch + cdouble cent + cfloat char class - cfloat - cdouble - creal const continue + creal dchar debug diff -uNr dmd-0.102/dmd/html/d/overview.html dmd-0.103/dmd/html/d/overview.html --- dmd-0.102/dmd/html/d/overview.html 2004-09-05 02:43:22.000000000 +0200 +++ dmd-0.103/dmd/html/d/overview.html 2004-10-19 02:37:50.000000000 +0200 @@ -18,7 +18,7 @@ [Search] [D] -
Last update Apr 17, 2004 +
Last update Oct 19, 2004

Overview

@@ -800,10 +800,6 @@

Stronger type checking -
Explicit initialization required - -
Unused local variables not allowed -
No empty ; for loop bodies
Assignments do not yield boolean results diff -uNr dmd-0.102/dmd/html/d/phobos.html dmd-0.103/dmd/html/d/phobos.html --- dmd-0.102/dmd/html/d/phobos.html 2004-09-01 11:14:32.000000000 +0200 +++ dmd-0.103/dmd/html/d/phobos.html 2004-10-16 23:22:38.000000000 +0200 @@ -195,6 +195,10 @@
std.random
Random number generation. +
std.recls +
Recursively search file system and (currently Windows + only) FTP sites. +
std.regexp
The usual regular expression functions. diff -uNr dmd-0.102/dmd/html/d/std_recls.html dmd-0.103/dmd/html/d/std_recls.html --- dmd-0.102/dmd/html/d/std_recls.html 1970-01-01 01:00:00.000000000 +0100 +++ dmd-0.103/dmd/html/d/std_recls.html 2004-09-30 18:37:50.000000000 +0200 @@ -0,0 +1,341 @@ + + + + + + Digital Mars - Phobos - std.recls + + + + + +[Home] +[Search] +[D] + +
Last update Sept 30, 2004 +
+ +
Phobos: std.recls
+ +
+recls - standing for recursive ls - is a platform-independent +recursive search library, designed and implemented by Matthew Wilson, as the first +exemplar project for his column Positive Integration in +C/C++ Users Journal. +
+recls currently supports recursive searching of file systems (UNIX and Windows), and +FTP sites (currently Windows-only). Future enhancements may include recursive-searching of the +Windows registry, source-code control systems, and, of course, FTP-searching for UNIX platforms. +
+recls is implemented in C++, using the +STLSoft +libraries (which are also bundled with Digital Mars; see +stlsoft.digitalmars.com), +and presents a C-API. recls is also mapped to a host of other languages and +technologies, including C++, COM, C#/.NET, Java, Ruby +and STL among an ever-expanding list. Given its non-trivial size, the recls D +mapping is a good place to learn about interfacing C libraries to D. +
+The recls homepage is www.recls.org, +from which updates to the library, and all the other language mappings, may be obtained. Support +for recls has evolved to piggy-back on the +STLSoft newsgroup, although +questions about using recls in D should be directed through the main +D newsgroup, and bugs in +recls (in D) should be reported to the +D bugs newsgroup. +
+The Windows version of the D mapping of recls uses a crude-but-adequate delay-loading +mechanism such that linking to WinInet.lib is not required. This strategy was necessitated by +D's linkage model, and was elected to avoid encumbering executables with something that they +may not use. There is are negative effects if the program explicitly uses WinInet.lib for +other aspects. +
+The recls object model is comprised of the following classes: +
- Entry
- FileSearch
- FtpSearch (currently Windows-only)
- ReclsException
- Search (base class of + FileSearch and + FtpSearch)
+the enum RECLS_FLAG: +
- RECLS_FLAG
+and the following functions: +
- getRoots()
- getPathNameSeparator()
- getPathSeparator()
- wildcardsAll()
- isDirectoryEmpty()
- calcDirectorySize()
+
+The basic usage is as follows: +
1. + Create a search instance, either FileSearch or + FtpSearch, e.g. +
```
+    // Enumerate all the zip and exe files on the Digital Mars FTP server
+    Search s = new FtpSearch("ftp.digitalmars.com", "anonymous", "", "/", "*.zip;*.exe", RECLS_FLAG.RECURSIVE | RECLS_FLAG.PASSIVE_FTP);
+  
```
  + or +
```
+    // Enumerate all the three-letter first-level sub-directories beginning with s of H:\SynSoft\D\phobos\
+    FileSearch s = new FileSearch("H:\SynSoft\D\phobos\", "s??", RECLS_FLAG.DIRECTORIES);
+  
```
  +
2. + Enumerate the search instance, using foreach. +
```
+    foreach(Entry e; s)
+    {
+      if(e.size < 2000)
+      {
+        writef(e.path);       // e.g. "/Digital_Mars_C++/STL"
+        writef(e.directory);  // e.g. "/Digital_Mars_C++/STL"
+        writef(e.file);       // e.g. "stlport.zip"
+        writef(e.fileName);   // e.g. "stlport"
+        writef(e.fileExt);    // e.g. "zip"
+        ...
+      }
+    }
+  
```
  + The many properties of the Entry class are used to provide + access to all attributes of file/directory entries. +
+
+ + +
std.recls.Entry
+ The Entry class has the following properties: +
+
+
char[] getPath()
+
char[] path()
+
The full path of the entry
+
+ +
char drive() - (Windows only)
+
The drive component of the entry's path
+
+ +
char[] directory()
+
The directory component of the entry's path
+
+ +
char[] directoryPath()
+
The full location component of the entry's path.
+
+ +
char[][] directoryParts()
+
An array of strings representing the parts of the Directory property
+
+ +
char[] file()
+
The file component of the entry's path
+
+ +
char[] shortFile()
+
The short equivalent of the entry's File property
+
+ +
char[] fileName()
+
The file name component of the entry's path
+
+ +
char[] fileExt()
+
The file extension component of the entry's path
+
+ +
d_time creationTime()
+
The time the entry was created
+
+ +
d_time modificationTime()
+
The time the entry was last modified
+
+ +
d_time lastAccessTime()
+
The time the entry was last accessed
+
+ +
d_time lastStatusChangeTime()
+
The time the entry's last status changed
+
+ +
recls_filesize_t fileSize()
+
The size of the entry
+
+ +
int isReadOnly()
+
Indicates whether the entry is read-only
+
+ +
int isDirectory()
+
Indicates whether the entry is a directory
+
+ +
int isLink()
+
Indicates whether the entry is a link
+
+
+
+
+ + +
std.recls.FileSearch
+ The FileSearch class derives from the + Search class, and has the following + methods: +
+
+
this(in char[] searchRoot, in char[] pattern, in uint flags)
+
Create a search object with the given searchRoot, pattern and flags +
+
searchRoot The root directory of the search. If null, or the empty string, the current directory is assumed
+
pattern The search pattern. If null all entries are returned (equivalent to specifying + wildcardsAll().) If the empty string, the search returns an empty result set. +
flags A combination of RECLS_FLAG flags which moderate the search
+
+
Note: pattern can be a composite pattern, e.g. "*.exe;*.zip;*.c??", but the separator must + be the correct one for the local operating system (see getPathSeparator()).
+
+
+
+
+ + +
std.recls.FtpSearch
+ The FtpSearch class derives from the + Search class, and has the following + methods: +
+
+
this(in char[] host, in char[] username, in char[] password, in char[] searchRoot, in char[] pattern, in uint flags)
+
Create a search object with the given searchRoot, pattern and flags +
+
host The name of the host providing the FTP service
+
username The username of the acount to use to log on to the FTP server
+
password The password of the acount to use to log on to the FTP server
+
searchRoot The root directory of the search. If null, or the empty string, the current directory is assumed
+
pattern The search pattern. If null all entries are returned (equivalent to specifying + wildcardsAll().) If the empty string, the search returns an empty result set. +
flags A combination of RECLS_FLAG flags which moderate the search
+
+
Note: pattern can be a composite pattern, e.g. "*.exe;*.zip;*.c??", but the separator must + be the correct one for the local operating system (see getPathSeparator()).
+
+
+
+
+ + +
std.recls.ReclsException
+ Exception class used by the recls module. +
+ + +
std.recls.Search
+ Base class of the FileSearch and + FtpSearch classes. Supports foreach. +
+ + +
std.recls.RECLS_FLAG
+ Enumeration, whose values control the search behaviour provided by the + FileSearch and + FtpSearch classes. +
+
+
FILES - Include files in search. Included by default if none specified
+
DIRECTORIES - Include directories in search. Not currently supported
+
LINKS - Include links in search. Ignored in Win32
+
DEVICES - Include devices in search. Not currently supported
+
RECURSIVE - Searches given directory and all sub-directories
+
NO_FOLLOW_LINKS - Does not expand links
+
DIRECTORY_PARTS - Fills out the directory parts. Supported from version 1.1.1 onwards
+
DETAILS_LATER - Does not fill out anything other than the path. Not currently supported
+
PASSIVE_FTP - Passive mode in FTP
+
+
+
+ + +
std.recls functions
+ Free functions provided by the recls module. +
+
+
+ +
char[][] getRoots();
+
Returns an array of all file-system roots on the local system.
+
+ On Unix, this always returns an array with a single entry which is "/". On Windows, + it will return an array of strings representing the drives, e.g. "C:", "D:", "H:", "Y:" +
. +
+ + +
char[] getPathNameSeparator();
+
Returns the symbol used to separate distinct path names in path name lists.
+
+ On UNIX this is "/"; on Win32 it is "\". +
. +
+ + +
char[] getPathNameSeparator();
+
Returns the symbol used to separate the directory parts within paths.
+
+ On UNIX this is ":"; on Win32 it is ";". +
. +
+ + +
char[] wildcardsAll();
+
Returns the wildcard symbol used to represent the "all files" for the current operating system.
+
+ On UNIX this is "*"; on Win32 it is "*.*". +
. +
+ + +
int isDirectoryEmpty(char[] dir);
+
int isDirectoryEmpty(Entry dir);
+
+ Determines whether the given directory is empty. +
. +
+ + +
recls_filesize_t calcDirectorySize(char[] dir, int bRecurse);
+
recls_filesize_t calcDirectorySize(Entry dir, int bRecurse);
+
+ Determines the size of the given directory. If bRecurse is non-0, it calculates the size of all + sub-directories, otherwise it counts only the sizes of the files in the given directory. +
. +
+ +
+
+ + +
Copyright (c) 2003-2004 by Matthew Wilson, Synesis Software Pty Ltd, All Rights Reserved + + +

New/Changed Features

Bugs Fixed

New/Changed Features

Bugs Fixed

D Strings vs C++ Strings

wccpp2 by Allan Odgaard

Lexical

Overview

Phobos: std.recls