lispval-to-address

Arguments: lispval

Returns an integer which represents the precise bit pattern representing lispval. The pattern includes the tag of the object, as well as either:

• the immediate data in the rest of the word
• the address of the object, as offset by the tag, and, depending upon the architecture, an additional offset which is always a multiple of 8 bytes (on 32-bit machines) or 16 bytes (on 64-bit machines). This extra offset can be seen in the [allegro-directory]/misc/lisp.h file as the macro TagOffset.

The integer returned by this function is the same value as is seen when print-unreadable-object uses the :identity option.

Users have occasionally been told about an internal function excl::pointer-to-address. lispval-to-address function is essentially an exported (and documented and supported) version of excl::pointer-to-address. Users who have code which refers to excl::pointer-to-address should replace it so lispval-to-address is called.

See also lispval-to-aligned-malloc-address.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.