japi-reset

Arguments: &optional tag

This operator was added in a patch release in April, 2014.

This function invalidates all the runtime tables and structures created by loading a set of generated Java API definitions. The Lisp functions defined by loading generated code are still defined but will signal error if called. The API definitions must be evaluated again in order to be effective.

If the generated code is loaded more than once or if several different generated files are loaded into the same Lisp, the resulting tables and structures are an accumulation of all the definitions. This function resets all this data for a fresh start.

The tag argument can be used to synchronize the loading of several generated files when they are loaded independently or in multiple threads. If several calls with non-nil and #'equal tag arguments take place in a Lisp image, only the first one will reset the tables; the subsequent ones will be ignored and will return nil. Each tag value can only be used once. If it needs to be used again for a full reset, a different tag value must be used in between.

If dynamically dispatched calls take place while definitions are reset and loaded, the results are unpredictable.

This function returns an integer that increases with each call.

See jlinker.htm for more information on the jLinker facility.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 9.0 release.
Created 2019.8.20.