Click here to Skip to main content
Click here to Skip to main content

DataStore - A template class for creating sequential access record files

, 15 Nov 2006 BSD
Rate this:
Please Sign up or sign in to vote.
A template class for creating sequential access record files

Introduction

"DataStore" is a template class that wraps C file handling routines in a straightforward manner. This can be used in place of C++ iostream classes for easy serialization of C++ objects.

Background

To understand the code presented here, you should have a basic knowledge of OOPs and C++ templates.

Using the code

For using DataStore, first include datastore.h using the #include preprocessor directive. The template argument to DataStore must be the name of a structure or class, the objects of which "DataStore" will read and write on the file. The constructor of DataStore takes the disk file name as its argument. This file must be opened using the Open() function before any read/write operations can take place. The file will be created, if it does not already exist.

struct Point 
{
  int x;
  int y;
};

DataStore ds("points.dat");
ds.Open();

For writing an object to the file, call the AddRecord() member function. The new record will be appended to the end of the file.

Point p;
p.x = 10;
p.y = 30;
ds.AddRecord(p);

DataStore searches records based on its position in the file. For this, you have to pass the position of the record to the FindRecord() member function. The following code reads the first record from the file:

Point pf = ds.FindRecord(0);
To search for a particular record based on some criteria, you should first get the total number of records in the file and then loop through the entire file until you find the record.
unsigned long recs = ds.GetRecordCount();
bool found = false;
for (unsigned long i=0;i

In the same way, ModifyRecord() and DeleteRecord() functions take the record index as their arguments to perform operations on the file.

ds.ModifyRecord(new_point,1);
ds.DeleteRecord(0);

After file operations are over, you should call the DataStore object's Close() function to release the file handle.

ds.Close();

The demo project creates a new data file, and inserts 100000 records into it. It then permits you to add new records and perform other file operations. (The add operation is performed automatically.) As the number of records grow, you will find that searching for newer records will become slower. This problem can be solved by adding indexing support by using some libraries like BDB. But as long as your application need not store millions of records, you can just be happy with the DataStore class as it is.

License

This article, along with any associated source code and files, is licensed under The BSD License

Share

About the Author

No Biography provided

Comments and Discussions

 
GeneralTwo questions PinmemberBenTsai28-Apr-05 2:17 
GeneralRe: Two questions PinmemberVijay Mathew Pandyalakal28-Apr-05 18:41 
GeneralRe: Two questions PinmemberBenTsai28-Apr-05 19:01 
GeneralRe: Two questions PinmemberVijay Mathew Pandyalakal28-Apr-05 22:57 
QuestionShouldnt it be? PinmemberCabaleiro8-Oct-03 21:11 
GeneralArticle Question PinmemberD N Harris8-Sep-03 7:48 
GeneralSuggest further extention/encapsulation.. Pinmemberc++developer28-Aug-03 23:12 
GeneralSerialization Pinmembersrana27-Aug-03 3:50 
GeneralDatastore - storing a class instead of struct Pinmemberrwomack26-Aug-03 12:12 
GeneralRe: Datastore - storing a class instead of struct [modified] PinmemberVijay Mathew Pandyalakal27-Aug-03 5:45 
Generaltwo suggestions PinmemberStober26-Aug-03 9:21 
GeneralRe: two suggestions PinmemberVijay Mathew Pandyalakal27-Aug-03 5:23 
Questioniostream.h? PinmemberDrPizza26-Aug-03 5:01 
GeneralRe: iostream.h? PinmemberJim Crafton27-Aug-03 7:29 
GeneralRe: iostream.h? PinsussAnonymous28-Aug-03 4:52 
Questionold c better than iostreams ? could you comment ? PinmemberJonathan de Halleux25-Aug-03 22:47 
Answer[Message Deleted] PinmemberVijay Mathew Pandyalakal27-Aug-03 5:34 
GeneralRe: old c better than iostreams ? could you comment ? PinmemberJonathan de Halleux27-Aug-03 5:40 
GeneralRe: old c better than iostreams ? could you comment ? Pinmemberakrc27-Aug-03 8:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150327.1 | Last Updated 15 Nov 2006
Article Copyright 2003 by AnOldGreenHorn
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid