WordCount Sample

Sample Overview

This sample offers an introduction to the base class library. It shows how to create an application that opens multiple files (specified on the command line) and counts each file's bytes, characters, words, and lines. The results from each file and the total of all files are sent to the console.

The following classes are used by the sample:

I/O
- FileStream
  - Used for its file access. This class is used to read to and write from files.
- StreamWriter
  - Used when the command-line arguments request that the output be sent to a file. The StreamWriter is used in conjunction with a FileStream instance to format text output to a file.
- StreamReader
  - Used to read the contents of a file for which the sample is counting words. The StreamReader is used in conjunction with a FileStream instance to read text from a file.
Collections
- ArrayList
  - Used as a general collection class for storing sets of objects.
- SortedList
  - Used as a collection class for storing sets of objects in a sorted manner.
- IEnumerator
  - Used directly to enumerate over sets of objects.
- IDictionaryEnumerator
  - Used directly to enumerate over indexed sets of objects.

Usage

clix wordcount [-a] [-o] [-f<output-pathname>] [-c<codepage>] filename

The following table shows the command-line options used by the sample.

Option	Description
-?	Shows usage information.
-a	Sorts word usage alphabetically.
-c	Specifies the codepage to use to read the file.
-f:outfile	Sends output to outfile instead of the console.
-o	Sorts word usage by occurrence and then alphabetically.

Sample Source and Build Output Locations

The sample source is found in rotor\samples\utilities\wordcount.

The source file is:

wordcount.cs

The build output location is %TARGETCOMPLUS%\samples\utilities\wordcount. The output file is an executable assembly named wordcount.exe.

Building the Sample

All samples are built from the buildall script.

You can also build all the samples by switching to the root of the sample directory, sscli\samples, and typing build -c.

You can build this specific sample by switching to the sample directory and typing build -c.

Running the Sample

These steps require that the Shared Source CLI (SSCLI) be already built and functional.

Run env.bat or source the env.csh or env.sh script files, depending on your platform.
Switch to the %TARGETCOMPLUS%\samples\\utilities\wordcount directory.
Type the following command:

clix wordcount.exe filename

where filename is the name of the file in which to count words and lines.