lclint annotations.
CVS patchset: 4104 CVS date: 2000/08/23 12:59:48
This commit is contained in:
parent
bb4c04321a
commit
e62a4131e4
14
lib/fprint.h
14
lib/fprint.h
|
@ -68,7 +68,7 @@ extern "C" {
|
|||
* @param sizeHint number of elements expected
|
||||
* @return pointer to initialized fingerprint cache
|
||||
*/
|
||||
/*@only@*/ fingerPrintCache fpCacheCreate(int sizeHint);
|
||||
/*@only@*/ fingerPrintCache fpCacheCreate(int sizeHint) /*@*/;
|
||||
|
||||
/**
|
||||
* Destroy finger print cache.
|
||||
|
@ -85,7 +85,7 @@ void fpCacheFree(/*@only@*/ fingerPrintCache cache);
|
|||
* @return pointer to the finger print associated with a file path.
|
||||
*/
|
||||
fingerPrint fpLookup(fingerPrintCache cache, const char * dirName,
|
||||
const char * baseName, int scareMemory);
|
||||
const char * baseName, int scareMemory) /*@*/;
|
||||
|
||||
/**
|
||||
* Return hash value for a finger print.
|
||||
|
@ -93,7 +93,7 @@ fingerPrint fpLookup(fingerPrintCache cache, const char * dirName,
|
|||
* @param key pointer to finger print entry
|
||||
* @return hash value
|
||||
*/
|
||||
unsigned int fpHashFunction(const void * key);
|
||||
unsigned int fpHashFunction(const void * key) /*@*/;
|
||||
|
||||
/**
|
||||
* Compare two finger print entries.
|
||||
|
@ -102,7 +102,7 @@ unsigned int fpHashFunction(const void * key);
|
|||
* @param key2 finger print 2
|
||||
* @return result of comparing key1 and key2
|
||||
*/
|
||||
int fpEqual(const void * key1, const void * key2);
|
||||
int fpEqual(const void * key1, const void * key2) /*@*/;
|
||||
|
||||
/**
|
||||
* Return finger prints of an array of file paths.
|
||||
|
@ -116,7 +116,8 @@ int fpEqual(const void * key1, const void * key2);
|
|||
*/
|
||||
void fpLookupList(fingerPrintCache cache, const char ** dirNames,
|
||||
const char ** baseNames, const int * dirIndexes,
|
||||
int fileCount, fingerPrint * fpList);
|
||||
int fileCount, fingerPrint * fpList)
|
||||
/*@modifies cache, *fpList @*/;
|
||||
|
||||
/**
|
||||
* Return finger prints of all file names in header.
|
||||
|
@ -125,7 +126,8 @@ void fpLookupList(fingerPrintCache cache, const char ** dirNames,
|
|||
* @param h package header
|
||||
* @retval fpList pointer to array of finger prints
|
||||
*/
|
||||
void fpLookupHeader(fingerPrintCache cache, Header h, fingerPrint * fpList);
|
||||
void fpLookupHeader(fingerPrintCache cache, Header h, fingerPrint * fpList)
|
||||
/*@modifies cache, *fpList @*/;
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
|
|
18
lib/hash.h
18
lib/hash.h
|
@ -12,16 +12,16 @@ extern "C" {
|
|||
#endif
|
||||
|
||||
/** */
|
||||
typedef unsigned int (*hashFunctionType) (const void * string);
|
||||
typedef unsigned int (*hashFunctionType) (const void * string) /*@*/;
|
||||
/** */
|
||||
typedef int (*hashEqualityType) (const void * key1, const void * key2);
|
||||
typedef int (*hashEqualityType) (const void * key1, const void * key2) /*@*/;
|
||||
|
||||
/**
|
||||
* Return hash value of a string
|
||||
* @param string string on which to calculate hash value
|
||||
* @return hash value
|
||||
*/
|
||||
unsigned int hashFunctionString(const void * string);
|
||||
unsigned int hashFunctionString(const void * string) /*@*/;
|
||||
|
||||
/**
|
||||
* Compare two hash table entries for equality.
|
||||
|
@ -29,7 +29,7 @@ unsigned int hashFunctionString(const void * string);
|
|||
* @param key2 entry 2
|
||||
* @return 0 if entries are equal
|
||||
*/
|
||||
int hashEqualityString(const void * key1, const void * key2);
|
||||
int hashEqualityString(const void * key1, const void * key2) /*@*/;
|
||||
|
||||
/**
|
||||
* Create hash table.
|
||||
|
@ -43,7 +43,7 @@ int hashEqualityString(const void * key1, const void * key2);
|
|||
* @return pointer to initialized hash table
|
||||
*/
|
||||
hashTable htCreate(int numBuckets, int keySize, int freeData,
|
||||
hashFunctionType fn, hashEqualityType eq);
|
||||
hashFunctionType fn, hashEqualityType eq) /*@*/;
|
||||
|
||||
/**
|
||||
* Destroy hash table.
|
||||
|
@ -57,7 +57,8 @@ void htFree( /*@only@*/ hashTable ht);
|
|||
* @param key pointer to key
|
||||
* @param data pointer to data value
|
||||
*/
|
||||
void htAddEntry(hashTable ht, /*@owned@*/ const void * key, /*@owned@*/ const void * data);
|
||||
void htAddEntry(hashTable ht, /*@owned@*/ const void * key,
|
||||
/*@owned@*/ const void * data) /*@modifies ht */;
|
||||
|
||||
/**
|
||||
* Retrieve item from hash table.
|
||||
|
@ -69,7 +70,8 @@ void htAddEntry(hashTable ht, /*@owned@*/ const void * key, /*@owned@*/ const vo
|
|||
* @return 0 on success, 1 if the item is not found.
|
||||
*/
|
||||
int htGetEntry(hashTable ht, const void * key, /*@out@*/ const void *** data,
|
||||
/*@out@*/ int * dataCount, /*@out@*/const void ** tableKey);
|
||||
/*@out@*/ int * dataCount, /*@out@*/ const void ** tableKey)
|
||||
/*@modifies *data, *dataCount, *tableKey @*/;
|
||||
|
||||
/**
|
||||
* Check for key in hash table.
|
||||
|
@ -77,7 +79,7 @@ int htGetEntry(hashTable ht, const void * key, /*@out@*/ const void *** data,
|
|||
* @param key pointer to key value
|
||||
* @return 1 if the key is present, 0 otherwise
|
||||
*/
|
||||
int htHasEntry(hashTable ht, const void * key);
|
||||
int htHasEntry(hashTable ht, const void * key) /*@*/;
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
|
|
Loading…
Reference in New Issue