Release cache

This method permits the Repository object to release the memory occupied by Interface Repository objects that have been implicitly referenced.

Syntax

Repository       receiver;
Environment     *env;

release_cache(receiver, env);

Parameters

receiver (Repository)

A pointer to an object of class Repository representing SOM's Interface Repository.

env (Environment *)

A pointer where the method can return exception information if an error is encountered.

Returns

rc

Remarks

This method allows the Repository object to release the memory occupied by implicitly referenced Interface Repository objects. Some methods (such as describe_contents and lookup_name) may cause some objects to be instantiated that are not directly accessible through object references that have been returned to the user. These objects are kept in an internal Interface Repository cache until the release_cache method is used to free them. The internal cache continuously replenishes itself over time as the need arises.

See the section entitled "A word about memory management" in the Interface Repository Framework in the SOM Toolkit User's Guide.

Original Class

Repository

Example Code

#include <repostry.h>

...

Repository repo;
Environment *ev;
sequence(ContainerDescription) scd;

...

scd = Container_describe_contents (
      (Container) repo, ev, "TypeDef", TRUE, -1);
Repository_release_cache (repo, ev);