| 1 | /*
 | 
|---|
| 2 |  * \file memoryusageobserver.cpp
 | 
|---|
| 3 |  *
 | 
|---|
| 4 |  * This class represents a Singleton for observing memory usage.
 | 
|---|
| 5 |  */
 | 
|---|
| 6 | #include "memoryusageobserver.hpp"
 | 
|---|
| 7 | 
 | 
|---|
| 8 | MemoryUsageObserver* MemoryUsageObserver::instance = NULL;
 | 
|---|
| 9 | 
 | 
|---|
| 10 | /**
 | 
|---|
| 11 |  * Constructor. Do not use this function. Use getInstance() instead.
 | 
|---|
| 12 |  *
 | 
|---|
| 13 |  * \return memory usage observer instance
 | 
|---|
| 14 |  */
 | 
|---|
| 15 | MemoryUsageObserver::MemoryUsageObserver() {
 | 
|---|
| 16 |   instance = NULL;
 | 
|---|
| 17 |   maximumSize = 0;
 | 
|---|
| 18 |   totalSize = 0;
 | 
|---|
| 19 | }
 | 
|---|
| 20 | 
 | 
|---|
| 21 | /**
 | 
|---|
| 22 |  * Destructor. Better use purgeInstance().
 | 
|---|
| 23 |  */
 | 
|---|
| 24 | MemoryUsageObserver::~MemoryUsageObserver() {
 | 
|---|
| 25 |   for (map<void*, size_t>::iterator current = memoryUsers.begin(); current != memoryUsers.end(); current++) {
 | 
|---|
| 26 |     memoryUsers.erase(current);
 | 
|---|
| 27 |   }
 | 
|---|
| 28 | 
 | 
|---|
| 29 |   maximumSize = 0;
 | 
|---|
| 30 |   totalSize = 0;
 | 
|---|
| 31 | }
 | 
|---|
| 32 | 
 | 
|---|
| 33 | /**
 | 
|---|
| 34 |  * Returns the singleton memory usage observer instance.
 | 
|---|
| 35 |  *
 | 
|---|
| 36 |  * \return memory usage observer instance
 | 
|---|
| 37 |  */
 | 
|---|
| 38 | MemoryUsageObserver* MemoryUsageObserver::getInstance() {
 | 
|---|
| 39 |   if (instance == NULL) {
 | 
|---|
| 40 |     instance = new MemoryUsageObserver;
 | 
|---|
| 41 |   }
 | 
|---|
| 42 | 
 | 
|---|
| 43 |   return instance;
 | 
|---|
| 44 | }
 | 
|---|
| 45 | 
 | 
|---|
| 46 | /**
 | 
|---|
| 47 |  * Purges the current memory usage observer instance.
 | 
|---|
| 48 |  */
 | 
|---|
| 49 | void MemoryUsageObserver::purgeInstance() {
 | 
|---|
| 50 |   if (instance != NULL) {
 | 
|---|
| 51 |     delete instance;
 | 
|---|
| 52 |   }
 | 
|---|
| 53 | 
 | 
|---|
| 54 |   instance = NULL;
 | 
|---|
| 55 | }
 | 
|---|
| 56 | 
 | 
|---|
| 57 | /**
 | 
|---|
| 58 |  * Adds memory.
 | 
|---|
| 59 |  *
 | 
|---|
| 60 |  * \param pointer to the allocated piece of memory
 | 
|---|
| 61 |  * \param size of the allocated memory
 | 
|---|
| 62 |  */
 | 
|---|
| 63 | void MemoryUsageObserver::addMemory(void* pointer, size_t size) {
 | 
|---|
| 64 |   // Memory might become reseized so we need to check whether the provided pointer is already tracked.
 | 
|---|
| 65 |   map<void*, size_t>::iterator current = memoryUsers.find(pointer);
 | 
|---|
| 66 |   if (current != memoryUsers.end()) {
 | 
|---|
| 67 |     totalSize -= current->second;
 | 
|---|
| 68 |   }
 | 
|---|
| 69 | 
 | 
|---|
| 70 |   memoryUsers[pointer] = size;
 | 
|---|
| 71 |   totalSize += size;
 | 
|---|
| 72 |   maximumSize = (totalSize > maximumSize) ? totalSize : maximumSize;
 | 
|---|
| 73 | }
 | 
|---|
| 74 | 
 | 
|---|
| 75 | /**
 | 
|---|
| 76 |  * Removes tracked memory. Prints a warning if untracked memory is to be released.
 | 
|---|
| 77 |  *
 | 
|---|
| 78 |  * \param pointer to the allocated piece of memory
 | 
|---|
| 79 |  * \param *msg optional error message
 | 
|---|
| 80 |  */
 | 
|---|
| 81 | void MemoryUsageObserver::removeMemory(void* pointer, const char *msg) {
 | 
|---|
| 82 |   map<void*, size_t>::iterator current = memoryUsers.find(pointer);
 | 
|---|
| 83 | 
 | 
|---|
| 84 |   if (current == memoryUsers.end()) {
 | 
|---|
| 85 |     cout << "WARNING: There is non-tracked memory to be freed. Pointer "
 | 
|---|
| 86 |       << pointer << " is not registered by MemoryUsageObserver: ";
 | 
|---|
| 87 |     if (msg != NULL)
 | 
|---|
| 88 |       cout << *msg;
 | 
|---|
| 89 |     cout << endl;
 | 
|---|
| 90 |     return;
 | 
|---|
| 91 |   }
 | 
|---|
| 92 | 
 | 
|---|
| 93 |   totalSize -= current->second;
 | 
|---|
| 94 |   memoryUsers.erase(current);
 | 
|---|
| 95 | }
 | 
|---|
| 96 | 
 | 
|---|
| 97 | /**
 | 
|---|
| 98 |  * Gets the size of currently allocated memory.
 | 
|---|
| 99 |  */
 | 
|---|
| 100 | size_t MemoryUsageObserver::getUsedMemorySize() {
 | 
|---|
| 101 |   return totalSize;
 | 
|---|
| 102 | }
 | 
|---|
| 103 | 
 | 
|---|
| 104 | /**
 | 
|---|
| 105 |  * Gets the maximum size of allocated memory until now.
 | 
|---|
| 106 |  */
 | 
|---|
| 107 | size_t MemoryUsageObserver::getMaximumUsedMemory() {
 | 
|---|
| 108 |   return maximumSize;
 | 
|---|
| 109 | }
 | 
|---|
| 110 | 
 | 
|---|
| 111 | /**
 | 
|---|
| 112 |  * Gets a map with pointers to the currently allocated memory ranges as keys and
 | 
|---|
| 113 |  * the allocated size as value.
 | 
|---|
| 114 |  */
 | 
|---|
| 115 | map<void*, size_t> MemoryUsageObserver::getPointersToAllocatedMemory() {
 | 
|---|
| 116 |   return memoryUsers;
 | 
|---|
| 117 | }
 | 
|---|