CMPS-109 Program 3 • Templates and Iterators


Category: You will Instantly receive a download link for .zip solution file upon Payment


5/5 - (5 votes)

1. Overview
In this assignment, you will implement template code and not use any template
classes from the STL. You will also write your own code to handle files. Refer to the
earlier assignment as to how to open and read files.
You may use the following includes, and if you think anything else is needed, post a
question to the mailing list: , , , , ,
, , , , .
Specifically, you may not use any classes that take template parameters, such as
, ,

, , , except for those you write yourself. Do
not use shared_ptr, and instead, explicitly manage pointers yourself using new and
2. Program Specification
The program is specified in the format of a Unix man(1) page.
keyvalue — manage a list of key and value pairs
keyvalue [-@ flags] [filename …]
Input is read from each file in turn. Before any processing, each input line is
echoed to cout, preceded by its filename and line number within the file. The
name of cin is printed as a minus sign (-).
Each non-comment line causes some action on the part of the program, as
described below. Before processing a command, leading and trailing white
space is trimmed off of the key and off of the value. White space interior to the
key or value is not trimmed. When a key and value pair is printed, the equivalent of the format string used is “%s = %s\n”. Of course, use , not
. The newline character is removed from any input line before processing. If there is more than one equal sign on the line, the first separates
the key from the value, and the rest are part of the value. Input lines are one
of the following :
Any input line whose first non-whitespace character is a hash (#) is
ignored as a comment. This means that no key can begin with a hash.
An empty line or a line consisting of nothing but white space is ignored.
A line consisting of at least one non-whitespace character and no equal
sign causes the key and value pair to be printed. If not found, the message
key: key not found
is printed. Note that the characters in italics are not printed exactly.
CMPS-109 • Spring 2015 • Program 3 • Templates and Iterators 2 of 5
The actual key is printed. This message is printed to cout.
key =
If there is only whitespace after the equal sign, the key and value pair is
deleted from the map.
key = value
If the key is found in the map, its value field is replaced by the new
value. If not found, the key and value are inserted in increasing lexicographic order, sorted by key. The new key and value pair is printed.
All of the key and value pairs in the map are printed in lexicographic
= value
All of the key and value pairs with the given value are printed in lexicographic order sorted by key.
The -@ option is followed by a sequence of flags to enable debugging output,
which is written to the standard error. The option flags are only meaningful to
the programmer.
Each operand is the name of a file to be read. If no filenames are specified, cin
is read. If filenames are specified, a filename consisting of a single minus sign
(-) causes cin to be read in sequence at that position. Any file that can not be
accessed causes a message in proper format to be printed to cerr.
0 No errors were found.
1 There were some problems accessing files, and error messages were
reported to cerr.
3. Implementation Sequence
In this assignment, you will constuct a program from scratch, using some of the
code from previous assignments.
(a) Study the behavior of misc/pkeyvalue.perl, whose behavior your program
should emulate. The Perl version does not support the debug option of your
(b) Copy Makefile from your previous assignment, and edit it so that it will build
and submit your new assignment.
(c) Implement your main program whose name is main.cpp, and handle files in the
same way as the sample Perl code. Instead of trying to use a map, just print
debug statements showing which of the five kinds of statements are recognized, printing out the key and value portion of the statement.
(d) Instead of from the STL, you will use xpair.
CMPS-109 • • Program 3 • Templates and Iterators 3 of 5
(e) You will be using a linear linked list to implement your data structure. This is
obviously unacceptable in terms of a real data structures problem, since unit
operations will run in O(n) time instead of the proper O(log2 n) time for a balanced binary search tree. But iteration over a binary search tree is rather
complex and will not contribute to your learning about how to implement templates. And balancing a BST is part of CMPS-101, which is not a prerequisite
for this course.
(f) Look at xless.h and misc/testxless.cpp, which show how to create and use an
xless object to make comparisons. The listmap class assumes this has already
been declared.
(g) The files *.tcc are explicit template instantiations. Templates are type-safe
macros and the source is needed at the point where they are compiled.
4. The main function
Replace the code in the main function to do options analysis. Then for each input
line, parse the line by splitting it up into two pieces separated by the first equal (=)
sign. Then trim leading and trailing white space off each end, and perform the
appropriate function.
(a) Use find_first_of to locate the first ’=’ in the string and then substr to pull
off the various parts.
(b) Use find_first_not_of and find_last_not_of to find the first and last nonwhitespace characters in the string. Write your own function trim.
(c) Use an if-else sequence to determine which command is being parsed.
5. Template class listmap
We now examine the class listmap, which is partially implemented for you. You
need not implement functions that are never called.
(a) template >
class listmap
defines the template class with three arguments. Key and Value are the elements to be kept in the list. Less is the class used to determine the ordering of
the list and defaults to xless.
(b) typedef Key key_type;
typedef Value mapped_type;
typedef xpair value_type;
are some standard names given to usual STL types. Note that the value type
is an xpair, not what is normally thought as the value, which here is called
the mapped type.
(c) struct link
represents the list itself and is contained in every node. The list is kept as a
circular doubly linked list with the list itself being the start and end, as well
as the end() result. In a list with n nodes, there are n +1 links, each node having a link, and the list itself having a link, but not node values.
CMPS-109 • Spring 2015 • Program 3 • Templates and Iterators 4 of 5
(d) struct node
is a private node used to hold a value type along with forward and backword
links to form a doubly linked list. It inherits from struct link. The private
function anchor() downcasts from a link to a node.
(e) listmap();
listmap (const listmap&);
listmap& operator= (const listmap&);
listmap (listmap&&);
listmap& operator= (listmap&&);
The usual six members are overriden and explicitly defined.
(f) iterator insert (const value_type&);
Note that insertion takes a pair as a single argument. If the key is already
there, the value is replaced, otherwise there is a new entry inserted into the
list. An iterator pointing at the inserted item is returned.
(g) iterator find (const key_type&) const;
Searches and returns an iterator. If find fails, it returns the end() iterator.
(h) iterator erase (iterator position);
The item pointed at by the argument iterator is deleted from the list. The
returned iterator points at the position immediately following that which was
(i) iterator begin();
iterator end();
The usual iterator generators. We don’t bother here with a constant iterator.
6. Template class listmap::iterator
Although the iterator is nested inside the list map, it is easier to read when specified separately.
(a) class listmap::iterator
specifies precisely which class the iterator belongs to.
(b) friend class listmap;
Only a listmap is permitted to construct a valid iterator.
(c) iterator (listmap* map, node* where);
The iterator keeps track of both the node and the list as a whole, so that end()
can return an iterator ‘‘off the end’’,
(d) value_type& operator*();
Returns a reference to some value type (key and value pair) in the list. Selections are then by dot (.).
(e) value_type* operator->();
Returns a pointer to some value type, from which fields can be selected with
an arrow (->).
(f) iterator& operator++(); //++itor
iterator& operator–(); //–itor
CMPS-109 • Spring 2015 • Program 3 • Templates and Iterators 5 of 5
Move backwards and forwards along the list. Moving off the end with ++ and
moving from an end iterator to the last element requires special coding.
(g) void erase();
Removes the key and value pair from the list.
7. What to Submit
Makefile, README, and all necessary C++ header and implementation files. And don’t
forget checksource. If you are using pair programming, also submit PARTNER.