Returns the maximum value of the number of bytes of memory malloced but not freed (memory in use) of the database
engine since the high-water mark was last reset.
| Arguments: |
The single argument is:
| reset [optional] |
True if the high-water mark should be reset, false if it should not be reset. The default if the argument is
omitted is false.
|
|
| Return value: |
The highest amount of memory used by the database engine, since any previous reset, in bytes.
|
| Remarks: |
The memory high-water mark is reset to the current number of bytes of memory in use, if and only if theresetarg true. The value returned by this method is the high-water mark prior to the
reset if a reset is done.
|
| Details |
The functionality of thememoryHighWatermethod is similar to that of the SQLite
sqlite3_memory_highwater API.
|
| Example: |
This example shows the effect of using / not using theresetargument:
| say |
| say 'Memory high water: ' .ooSQLite~memoryHighWater |
| say 'Memory high water: ' .ooSQLite~memoryHighWater |
| say 'Memory high water (reset):' .ooSQLite~memoryHighWater(.true) |
| say 'Memory high water: ' .ooSQLite~memoryHighWater |
| say |
|
| /* Output might be: |
|
| Memory high water: 93664 |
| Memory high water: 93664 |
| Memory high water (reset): 93664 |
| Memory high water: 91712 |
|
| -- Note that the return when the reset is done is the current high wated mark, not the |
| -- value after the reset. |
| */
|
|