Component /dat/lib/utility/memory

Memory provides an untyped variable for temporarily holding a document. Memory will retain the last non control document received on the input port. The retained document will be sent to the output port upon receipt of a signal on the send pin or receipt of a <cx:send> control document on the input port. Memory is cleared thereby discarding the retained document upon receipt of a signal on the cleared pin or receipt of a <cx:clear> document on the input port.

After sending the retained document to the output port, a signal will be sent on the sent pin.

After clearing the retained document, a signal will be sent on the cleared pin.

If a signal is received on the send pin or a <cx:send> control document is received on the input port at the time that the memory is cleared, as error document will be sent on the error port.

Pins

• send the retained document will be sent on the output port upon receipt of a signal on this pin. If the memory is not retaining a document, an error document will be sent on the error port.
• clear the retained document will be discarded and the memory set as cleared upon receipt of a signal on this pin.
• sent after sending a document on the output port, a signal is sent on this pin.
• cleared after discarding the retained document and setting the memory as cleared, a signal is sent on this pin.

Ports

• input the last non control document received on this port will be retained by the memory. If a <cx:send> control document is received on this port, the retained document will be sent on the output port. If a <cx:clear> control document is received on this port the retained document will be discarded and the memory will be set as cleared.
• output on receipt of a signal on the send pin or a <cx:send> on the input port the retained document will be sent on this port. If there is not a retained document, an error document will be sent on the error port.
• output on receipt of a signal on the send pin or a <cx:send> on the input port at the time that the memory is cleared, an error document will be sent on this port.

Properties