/usr/include/gsmlib/gsm_sorted_phonebook.h is in libgsmme-dev 1.10+20120414.gita5e5ae9a-0.3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | // *************************************************************************
// * GSM TA/ME library
// *
// * File: gsm_sorted_phonebook.h
// *
// * Purpose: Alphabetically sorted phonebook
// * (residing in files or in the ME)
// *
// * Author: Peter Hofmann (software@pxh.de)
// *
// * Created: 25.6.1999
// *************************************************************************
#ifndef GSM_SORTED_PHONEBOOK_H
#define GSM_SORTED_PHONEBOOK_H
#include <gsmlib/gsm_sorted_phonebook_base.h>
#include <gsmlib/gsm_phonebook.h>
#include <gsmlib/gsm_util.h>
#include <gsmlib/gsm_map_key.h>
#include <string>
#include <map>
#include <fstream>
namespace gsmlib
{
// The class SortedPhonebook makes the phonebook more manageable:
// - empty slots in the ME phonebook are hidden by the API
// - the class transparently handles phonebooks that reside in files
class SortedPhonebook : public SortedPhonebookBase
{
private:
bool _changed; // true if file has changed after last save
bool _fromFile; // true if phonebook read from file
bool _madeBackupFile; // true if backup file was created
SortOrder _sortOrder; // sort order for the phonebook
bool _useIndices; // if phonebook from file: input file had
// indices; will write indices, too
bool _readonly; // =true if read from stdin
std::string _filename; // name of the file if phonebook from file
PhonebookMap _sortedPhonebook; // phonebook from file
PhonebookRef _mePhonebook; // phonebook if from ME
// convert CR and LF in string to "\r" and "\n" respectively
std::string escapeString(std::string s);
// convert "\r" and "\n" to CR and LF respectively
// start parsing with pos, stop when CR, LF, 0, or '|' is encountered
std::string unescapeString(char *line, unsigned int &pos);
// initial read of phonebook file
void readPhonebookFile(std::istream &pbs, std::string filename) throw(GsmException);
// synchronize SortedPhonebook with file (no action if in ME)
void sync(bool fromDestructor) throw(GsmException);
// throw an exception if _readonly is set
void checkReadonly() throw(GsmException);
public:
// iterator defs
typedef SortedPhonebookIterator iterator;
typedef PhonebookMap::size_type size_type;
// constructor for file-based phonebook
// expect indices in file if useIndices == true
// read from file
SortedPhonebook(std::string filename, bool useIndices)
throw(GsmException);
// read from stdin or start empty and write to stdout
SortedPhonebook(bool fromStdin, bool useIndices)
throw(GsmException);
// constructor for ME-based phonebook
SortedPhonebook(PhonebookRef mePhonebook) throw(GsmException);
// return maximum telephone number length
unsigned int getMaxTelephoneLen() const;
// return maximum entry description length
unsigned int getMaxTextLen() const;
// handle sorting
void setSortOrder(SortOrder newOrder);
SortOrder sortOrder() const {return _sortOrder;}
// phonebook traversal commands
// these are suitable to use stdc++ lib algorithms and iterators
// ME have fixed storage space implemented as memory slots
// that may either be empty or used
// traversal commands
iterator begin() {return _sortedPhonebook.begin();}
iterator end() {return _sortedPhonebook.end();}
// the size macros return the number of used entries
int size() const {return _sortedPhonebook.size();}
int max_size() const;
int capacity() const;
bool empty() const throw(GsmException) {return size() == 0;}
// existing iterators remain valid after an insert or erase operation
// note: inserting many entries in indexed mode is inefficient
// if the sort order is not set to indexed before
// return position
// insert only writes to available positions
// warning: insert fails silently if size() == max_size()
iterator insert(const PhonebookEntryBase& x) throw(GsmException);
iterator insert(iterator position, const PhonebookEntryBase& x)
throw(GsmException);
PhonebookMap::size_type count(std::string &key)
{return _sortedPhonebook.count(PhoneMapKey(*this, lowercase(key)));}
iterator find(std::string &key)
{return _sortedPhonebook.find(PhoneMapKey(*this, lowercase(key)));}
iterator lower_bound(std::string &key)
{return _sortedPhonebook.lower_bound(PhoneMapKey(*this,
lowercase(key)));}
iterator upper_bound(std::string &key)
{return _sortedPhonebook.upper_bound(PhoneMapKey(*this,
lowercase(key)));}
std::pair<iterator, iterator> equal_range(std::string &key)
{return _sortedPhonebook.equal_range(PhoneMapKey(*this,
lowercase(key)));}
PhonebookMap::size_type count(int key)
{return _sortedPhonebook.count(PhoneMapKey(*this, key));}
iterator find(int key)
{return _sortedPhonebook.find(PhoneMapKey(*this, key));}
iterator lower_bound(int key)
{return _sortedPhonebook.lower_bound(PhoneMapKey(*this, key));}
iterator upper_bound(int key)
{return _sortedPhonebook.upper_bound(PhoneMapKey(*this, key));}
std::pair<iterator, iterator> equal_range(int key)
{return _sortedPhonebook.equal_range(PhoneMapKey(*this, key));}
size_type erase(std::string &key) throw(GsmException);
size_type erase(int key) throw(GsmException);
void erase(iterator position) throw(GsmException);
void erase(iterator first, iterator last) throw(GsmException);
void clear() throw(GsmException);
// synchronize SortedPhonebook with file (no action if in ME)
void sync() throw(GsmException) {sync(false);}
// destructor
// writes back change to file if phonebook is in file
virtual ~SortedPhonebook();
};
// typedef Ref<SortedPhonebook> SortedPhonebookRef;
};
#endif // GSM_SORTED_PHONEBOOK_H
|