+
+
[Home]
[Search]
[D]
-Last update Aug 28, 2004 -
+
Last update Apr 03, 2005 +
D Links
These are links to other D resources!-
-
- Japanese Language D sites
-
-
-
-
- The Digital Mars D site translated to - Japanese. - -
- A - tutorial of the D language. - -
- - D wiki site - -
- Using - - using Direct3D9 in the D language. - -
- Windows header files. - -
- - d_cpp, a tool help to access C++ libraries from D. +
- The wiki for the D programming + language: + Wiki4D. -
- - Some import libraries. +
- The wiki for the D's runtime library + Phobos. -
- - barrage 360 deg., - a viewer of BulletML. - A sample of d_cpp. +
- dsource.org + is an open source community for the D Programming Language. + Its goal is to provide an environment conducive to open-source + development, including forums, source-code control, bug-tracking, + and distribution. -
- - TUMIKI Fighters game implemented in D. +
- Ben Hinkle's D page + contains several D-related projects: + -
- A small - - sample game. +
- Andy's D Page -
- Shinchiro.h's Japanese D resource page. -
- SynSoft's D Page provides + a number of free D libraries. SynSoft is an imprint of + Synesis Software, + which provides free D, + Java, .NET, Perl and Python libraries. SynSoft has contributed several + modules to the D standard library, and is currently working on a + standard template library - the DTL. -
- Open Source Development for D at dsource.org. Project hosting, - discussion forums, tutorials.
- Check for a D user's group in your community. @@ -88,13 +91,13 @@ A7Xpg, written in D.
- Andy Friesen has taken - SWIG + SWIG and modified it to generate code for D.
- Windows Developer Network's Fall 2003 issue - compares + + compares D with C, C++, C# and Java. @@ -106,19 +109,14 @@ Zeus for Windows is finally out. This release comes with D compiler (*) and keywords predefined and it also has a ctags program (xtags.exe) that supports the D language. - (*) For the D compiler to work within Zeus the user will need - to download and install the compiler from www.digitalmars.com/d/. If + (*) For the D compiler to work within Zeus the user will need + to download and install the compiler from www.digitalmars.com/d/. If it is already installed it should be automatic.
- KDE Linux Support for D
- Mike Wynn's D Win32 COM libraries. -
- The wiki for the D programming language: - Wiki4D. - -
- The wiki for the D's runtime library - Phobos.
- The DIDE from Atari-Soldiers.
@@ -134,9 +132,9 @@
- urlopen: Open a URL as a stream (http, file, and ftp schema supported).
- urlread: Open a URL and read its contents. -
- urllistdir: List a directory, return an array of URLStat (file and ftp +
- urllistdir: List a directory, return an array of URLStat (file and ftp schema supported). -
- urlencode, urldecode: Encode and decode the URL. The above functions +
- urlencode, urldecode: Encode and decode the URL. The above functions expect a decoded URL.
- Pavel's DedicateD site.
- Lots of D projects with source code, FAQs, D news, etc.
+ Lots of D projects with source code, FAQs, D news, etc.
- Dr. Dobb's January 2005 has a
cover story
- on D.
+ on D.
- Dr. Dobb's February 2002 has a
cover story
- on D.
+ on D.
- D's appearance on
- slashdot.
+ slashdot.
- - A page on D on the wikiwiki, where computer languages +
- A page on D on the wikiwiki, where computer languages
get discussed. See
Dee Language.
-
+
-
The Pragmatic Programmers
-
+
-
- Gnu D compiler project on SourceForge.
+ Gnu D compiler project on SourceForge.
Come join and make Gnu D a reality!
-
+
-
The D Journal (coming soon!)
-
+
-
The Code Moon
-
+
-
The OpenD project.
-
+
-
99 Bottles.
-
+
-
OO Programming Newsletter #30 from Bruce Eckel.
-
+
-
Open Directory: Computers: Programming: Languages: D.
-
+
- DDevil's
language shootout D benchmarks.
-
+
- DServicesAPI
- Lua API for D. -
- Andy's D Page - -
- SynSoft's D Page provides - a number of free D libraries. SynSoft is an imprint of - Synesis Software, - which provides free D, - Java, .NET, Perl and Python libraries. SynSoft has contributed several - modules to the D standard library, and is currently working on a - standard template library - the DTL.
- Dprogramming.com @@ -249,7 +238,7 @@
- MKoD
- D Programming
- Language (MKoD == Magikal Kingdom of Dreams)
+ Language (MKoD == Magikal Kingdom of Dreams)
Always expanding, currently the site contains projects (ex: like the Financial Pkg), examples (in plain D code, or a mix of D with Windows APIs), converted @@ -259,7 +248,44 @@ programming 101), and D site banners. - Deja's D.NET PreAlpha Release. +
- Japanese Language D sites
+
-
+
+
- The Digital Mars D site translated to + Japanese. + +
- A + tutorial of the D language. + +
- + D wiki site + +
- Using + + using Direct3D9 in the D language. +
- Windows header files. + +
- + d_cpp, a tool help to access C++ libraries from D. + +
- + Some import libraries. + +
- + barrage 360 deg., + a viewer of BulletML. + A sample of d_cpp. + +
- + TUMIKI Fighters game implemented in D. + +
- A small + + sample game. + +
- Shinchiro.h's Japanese D resource page. +
+
- Cut & paste the following free images on your web pages of interest to +Cut & paste the following free images on your web pages of interest to D programmers:
- 
- 
- 
- 
- 
- 
- 
- 
- 
-
-
- 
+
+
+
+
+
+
+
+
+
+
+
+
Corto's
D button images:
- 
+
@@ -317,9 +343,16 @@ target="_top" title="Wiki 4 D">feedback and comments regarding this page. -
Copyright (c) 1999-2004 by Digital Mars, All Rights Reserved +
+
+
+
+
+
+[Home]
+[Search]
+[D]
+
+Last update 8th March 2005 +
+ +
Phobos: std.openrj
+ ++Open-RJ is an open-source library that implements readers of the Record-Jar +structured text file format, designed and implemented by Matthew Wilson, as an +exemplar project for his column Positive Integration in +C/C++ Users Journal. +
+It is implemented in C & C++, with a C-API. +The implementation of the basic library is platform-independent. Mappings are +provided to several languages (including C++, +D, +Ruby +and +STL), +and others (COM, Java, .NET, Perl, Python) are planned. In addition to +platform-independence, the library focuses on small runtime +costs - memory and speed - and the classic UNIX attributes of +discoverability and visibility. +
+ +What is the Record-Jar format?
++As described in the excellent book +"The Art Of UNIX Programming", a Record-Jar structured format file +consists of records and fields. +
++A field is a single line - optionally extended with trailing '\' - that contains +a name, separated from an optional value by ':'. +
++A record is a list of fields, whose contents are arbitrary and can vary between +records in the same database. Records are separated by a line that begins with +"%%". The record separator also acts as a comment, so +anything can come on a record separator line after the first two characters. +
++A database is a correctly parsed Record-Jar file. The Open-RJ API (and language +mappings) provide access to all the records in the database and the complete set +of fields. Hence, you may work with fields on a per-record basis, or treat the database +as a single record and with all fields in the database. +
++A very simple Record-Jar file, representing a Pets Database, is shown below: +
+ ++Name: Elsa +Species: Dog +Breed: Mixed +%% +Name: Fluffy Kitten +Species: Cat +%% +Name: Rebel +Species: Dog +Breed: German \ + Shepherd +%% +Name: Pepper +Species: Dog +Breed: Border Collie +%% +Name: Samson +Species: Dog +Breed: Ridgeback +%% +Name: Sheltie +Species: Dog +Breed: Shetland \ + Sheepdog +%% +Name: Sparky +Species: Cat +%% ++ +
+And that's pretty much all there is to it. There are no restrictions on what fields may +be in a record, and no controls over whether all records have the same fields or not. +That's the job of higher layers of application functionality. We keep Record-Jar simple +so it's reliable, portable and fast, and it's those things in spades! +
+ +std.openrj
++The D mapping of Open-RJ is packaged with Phobos in the std.openrj +module. It consists of four classes: +
-
+
- Database +
- DatabaseException +
- Field +
- InvalidKeyException +
- OpenRJException +
- Record +
-
+
- ORJ_FLAG + +
-
+
-
+ Create a database instance, on an existing Open-RJ database file, e.g.
+
+ Database db = new Database("pets.orj", ORJ_FLAG.ELIDE_BLANK_RECORDS); +
+
+ -
+ Enumerate over the records in the database, by using foreach:
+
+ foreach(Record r; db) + { + . . . // Process the record + } +
+ or by indexed lookup (which returns a Record instance): ++ for(int i = 0; i < db.length; ++i) + { + Record r = db[i]; + + . . . // Process the record + } +++ Processing of the record may be done by either ... +
+
+ -
+ ... enumerating the fields in the record, by using foreach:
+
+ foreach(Field f; r) + { + char[] name = f.name; + char[] value = f.value; + + printf(" %.*s=%.*s\n", name, value); // e.g. "Breed=German Shepherd" + } +
+ or by indexed lookup (which returns a Field instance): ++ for(int i = 0; i < r.length; ++i) + { + Field f = r[i]; + + . . . // Process the field + } ++
+ -
+ ... or it might be by field lookup or by name (which returns a string):
+
+ printf(" The value of the \"Species\" field is %.*s\n", r["Species"]); ++
+
+
+
+ std.openrj.Database
+ The Database class has the following methods:
+
-
+
- this(in char[] contents, in uint flags = 0) +
- Create a database object representing the given database contents
+
+
- contents The contents (or full path) of the database, where lines are separated by carriage-returns
+- flags A combination of ORJ_FLAG flags + which affect the processing of the Jar file
++
- Note: throws a DatabaseException + if the contents do not represent a + correctly formed Open-RJ database
++ +
- this(in char[][] lines, in uint flags = 0) +
- Create a database object representing the given database contents
+
+
- lines The database contents as an array of lines
+- flags A combination of ORJ_FLAG flags + which affect the processing of the Jar file
++
- Note: throws a DatabaseException + if the contents do not represent a + correctly formed Open-RJ database
++ +
- Record opIndex(uint index) +
- The record at the given index +
- Note: the function gives undefined behaviour if the index is invalid +
- Record[] getRecordsContainingField(char[] fieldName) +
- Returns an array of all records that contain a Field + with the given name +
- fieldName The name of the field +
- Record[] getRecordsContainingField(char[] fieldName, char[] fieldValue) +
- Returns an array of all records that contain a Field + with the given name and value +
- fieldName The name of the field +
- fieldValue The value of the field. May be null, in which case the semantics + are identical to getRecordsContainingField +
-
+
+
+
+ +
+
+ +
-
+
- char[] jarName() +
- The name of the database Jar file +
- uint flags() +
- The flags specified in the constructor +
- Record[] records() +
- An array of all records in the database +
- Field[] fields() +
- An array of all fields in the database +
- uint numFields() +
- The number of fields in the database +
- uint numRecords() +
- The number of records in the database +
- uint length() +
- The number of records in the database +
-
+
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+
+
+ std.openrj.Record
+ The Record class has the following methods:
+
-
+
- Field opIndex(uint index) +
- Returns the field at the given index +
- Note: the function gives undefined behaviour if the index is invalid +
- char[] opIndex(char[] fieldName) +
- Returns the value of the (first) field with the given name +
- fieldName The name of the field +
- Note: throws an InvalidKeyException if no field is found +
- Field getField(char[] fieldName) +
- Returns the (first) field with the given name +
- fieldName The name of the field +
- Note: throws an InvalidKeyException if no field is found +
- Field findField(char[] fieldName) +
- Returns the (first) field with the given name +
- fieldName The name of the field +
- Note: return null if no field is found +
- bool hasField(char[] fieldName) +
- Returns true if the record contains one or more fields with the given name +
- fieldName The name of the field +
-
+
+
+ +
+
+
+ +
+
+
+ +
+
+
+ +
+
+ +
-
+
+
+
+
+ std.openrj.Field
+ The Field class has the following properties:
+ methods:
+
-
+
- char[] name() +
- The name of the field +
- char[] value() +
- The value of the field +
- Record record() +
- The record within which the field resides. May be null +
-
+
+ +
+ +
+ +
+
+
+ std.openrj.OpenRJException
+ Base exception class used by the openrj module.
+
+
+
+ std.openrj.DatabaseException
+ Exception class, derived from OpenRJException,
+ thrown if the database Jar file cannot be opened, or its contents do not represent a
+ correctly formed Open-RJ database.
+
+ The DatabaseException class has the following properties: + methods: +
-
+
- ORJRC rc() +
- The general error code associated with the exception +
- ORJ_PARSE_ERROR parseError() +
- The parsing error code associated with the exception +
- int lineNum() +
- The lineNum associated with the exception +
-
+
+ +
+ +
+ +
+
+
+ std.openrj.InvalidKeyException
+ Exception class, derived from OpenRJException,
+ thrown when named fields are not found.
+
+
+
+ std.openrj.ORJ_FLAG
+ Enumeration, whose values control the loading behaviour of the
+ Database class.
+
-
+
- ORDER_FIELDS - Arranges the fields in alphabetical order +
- ELIDE_BLANK_RECORDS - Causes blank records to be ignored +
-
+
+
+
+ std.openrj.ORJRC
+ Enumeration representing general database processing errors encountered in
+ the loading of the Database class.
+
-
+
- SUCCESS - Operation was successful +
- CANNOT_OPEN_JAR_FILE - The given file does not exist, or cannot be accessed +
- NO_RECORDS - The database file contained no records +
- OUT_OF_MEMORY - The API suffered memory exhaustion +
- BAD_FILE_READ - A read operation failed +
- PARSE_ERROR - Parsing of the database file failed due to a syntax error +
- INVALID_INDEX - An invalid index was specified +
- UNEXPECTED - An unexpected condition was encountered +
- INVALID_CONTENT - The database file contained invalid content +
-
+
+
+
+ std.openrj.ORJ_PARSE_ERROR
+ Enumeration representing database parsing errors encountered in
+ the loading of the Database class.
+
-
+
- SUCCESS - Parsing was successful +
- RECORD_SEPARATOR_IN_CONTINUATION - A record separator was encountered during a content line continuation +
- UNFINISHED_LINE - The last line in the database was not terminated by a line-feed +
- UNFINISHED_FIELD - The last field in the database file was not terminated by a record separator +
- UNFINISHED_RECORD - The last record in the database file was not terminated by a record separator +
-
+
+ + +
Copyright (c) 2004 by Matthew Wilson, Synesis Software Pty Ltd, All Rights Reserved + + + + \ No newline at end of file diff -uNr dmd-0.119/dmd/html/d/std_stream.html dmd-0.120/dmd/html/d/std_stream.html --- dmd-0.119/dmd/html/d/std_stream.html 2005-03-16 18:33:04.000000000 +0100 +++ dmd-0.120/dmd/html/d/std_stream.html 2005-04-01 12:07:16.000000000 +0200 @@ -1,3 +1,4 @@ +