DQ_Put ( deque ; item )

Puts a new item at the front of a deque or queue

Average rating: 4.5 (24 votes) Log in to vote

Stephen Hanna
Stephen J. Hanna Consulting
http://www.sjhanna.com

Sample input:

DQ_Put( deque ; item )

Sample output:

(none)

Function definition: (Copy & paste into FileMaker's Edit Custom Function window)

//	D E Q U E   M A N I P U L A T I O N   F U N C T I O N S
//
//	Function Name:	DQ_Put
//	Parameters:	deque	The name (as a text string) of the global variable containing the list of values
//			value	The value to be added to the back (bottom) of the list
//	Returns:	deque
//	Side Effects:	deque	now has value added as its new rightmost (bottom) element
//	Exceptions:	Returns '?' if deque does not contain a valid variable name
//

Let (	[ $__A = deque
	; $__B = Quote( List( Evaluate( deque ); value ) )
	]
	; Evaluate( "Let (" & $__A & " = " & $__B & "; $__A )" )
)

This is a "put" function for a package implementing double-ended queues (DeQues). DQ_Put( deque ) adds the specified item to the rightmost (bottom) end of the specified Deque. See the description of DQ_New( ) for a complete description.

A typical usage scenario would be:

Set Variable [ $myQueue ; DQ_New ( "apple" ) ]
Set Variable [ $dummy ; DQ_Put ( $myQueue ; "kumquat" ) ]
Set Variable [ $fruit ; DQ_Pull ( $myQueue ) ] // $fruit = "kumquat"

Comments

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

DQ_Put ( deque ; item )

Comments

Support this website.

Support this website.