This page is for an old version of Hexaly Optimizer. We recommend that you update your version and read the documentation for the latest stable release.

LSPReferenceScope Class

class localsolver.modeler.LSPReferenceScope

A LSPReferenceScope contains a collection of references that can be released together. It simplifies the memory management of objects returned from the modeler API.

When you access a modeler object from the Python API, your Python program takes a new reference to that modeler object. These references are automatically deleted when the associated LSPModeler object is destroyed. But in the meantime references can prevent objects from being freed even if they are no longer used in the modeler. This is especially true if the interactions between the modeler and your LSP programs are complex and are not limited to a few exchanges at the beginning/end of the resolution.

In this case, a LSPReferenceScope allows you to limit the life of your references and can help you to preserve memory.

Since:

11.5

Summary

Special methods

__init__

Creates a new LSPReferenceScope object associated with the modeler in parameter.

__exit__

Releases all references associated with this scope.

Special methods

LSPReferenceScope.__init__(modeler)

Creates a new LSPReferenceScope object associated with the modeler in parameter. All references created from that point anywhere in the API will be automatically associated with this new scope. All these references can then be released if you use the with statement).

Parameters:

modeler – The associated modeler.

LSPReferenceScope.__exit__(*args)

Releases all references associated with this scope. It is also disassociated from the modeler and the previous scope is restored as the current one. If the scope has already been disposed then this method do nothing and returns immediately. This method is usually never called directly. It is called by Python in a with statement.

Note: Releasing a reference does not necessarily imply that the underlying modeler object is destroyed. It is only destroyed if no more references point to it.