The BOOST_PP_ARRAY_INSERT macro inserts an element into an array.

Usage

BOOST_PP_ARRAY_INSERT(array, i, elem)

Arguments

array
The array into which an element is to be inserted.
i
The zero-based position in array where an element is to be inserted.  Valid values range from 0 to BOOST_PP_ARRAY_SIZE(array).
elem
The element to insert.

Remarks

This macro inserts elem before the element at index i.
If the operation attempts to create an array that is larger than BOOST_PP_LIMIT_TUPLE, the result is undefined.
This macro uses BOOST_PP_WHILE interally.  Therefore, to use the d parameter passed from other macros that use BOOST_PP_WHILE, see BOOST_PP_ARRAY_INSERT_D.

See Also

Requirements

Header:  <boost/preprocessor/array/insert.hpp>

Sample Code

#include <boost/preprocessor/array/insert.hpp>

#define ARRAY (3, (a, b, d))

BOOST_PP_ARRAY_INSERT(ARRAY, 2, c) // expands to (4, (a, b, c, d))
© Copyright Housemarque Oy 2002
© Copyright Paul Mensonides 2002

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at www.boost.org/LICENSE_1_0.txt)