/usr/include/wvstreams/wvstringcache.h is in libwvstreams-dev 4.6.1-12~deb9u1.
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 | /* -*- Mode: C++ -*-
* Worldvisions Weaver Software:
* Copyright (C) 2005 Net Integration Technologies, Inc.
*
* Definition for the WvStringCache class.
*/
#ifndef __WVSTRINGCACHE_H
#define __WVSTRINGCACHE_H
#include "wvstringtable.h"
/**
* A cache table of WvString objects. If you think you might be reusing
* the same string objects over and over (for example, because the user
* provides the same string value a million times in a config file you're
* reading), you might be able to save a lot of memory by sharing the
* strings via a WvStringCache.
*
* To potentially share a string, call get(string), throw away the input
* string, and use the output string (which is guaranteed to have the same
* content) in its place. The string will be saved in the cache table for
* next time.
*
* Every once and a while, you should call clean() to remove any strings from
* the table that are no longer referenced elsewhere. This is especially
* important after deleting a large data structure, because you won't actually
* free up the memory used by those strings until clean() is called.
*
* All WvStringCaches in the app are shared, to optimize the benefits of
* the cache.
*/
class WvStringCache
{
static WvStringTable *t;
static int refcount;
static size_t clean_threshold;
public:
WvStringCache();
~WvStringCache();
/** Get a shared string corresponding to 's'. */
WvString get(WvStringParm s);
/** Remove any now-unused strings from the cache. */
void clean();
};
#endif // __WVSTRINGCACHE_H
|