Boost C++ Libraries

Push an array formed by popping n values from the stack.

Synopsis

void
push_array(
    std::size_t n);

Description

This function pushes an array value onto the stack. The array is formed by first popping the top n values from the stack. If the stack contains fewer than n values, or if any of the top n values on the stack is a key, the behavior is undefined.

Example

The following statements produce an array with the contents 1, 2, 3:

value_stack st;

// reset must be called first or else the behavior is undefined
st.reset();

// Place three values on the stack
st.push_int64( 1 );
st.push_int64( 2 );
st.push_int64( 3 );

// Remove the 3 values, and push an array with those 3 elements on the stack
st.push_array( 3 );

// Pop the object from the stack and take ownership.
value jv = st.release();

assert( serialize(jv) == "[1,2,3]" );

// At this point, reset must be called again to use the stack

Parameters