bdljsn::JsonArray Class Reference

#include <bdljsn_json.h>

Detailed Description

This type is designed to replicate much of the standard sequence container interface, eliding interfaces that are less relevant for a non-generic container.

Note

Note that a bsl::vector is chosen for the implementation because our implementation permits the element type to be incomplete (when just spelling the type name).

See bdljsn_json

Public Types
typedef Elements::iterator	Iterator
typedef Elements::const_iterator	ConstIterator
typedef Elements::value_type	value_type
typedef Elements::reference	reference
typedef Elements::const_reference	const_reference
typedef Elements::iterator	iterator
typedef Elements::const_iterator	const_iterator
typedef Elements::difference_type	difference_type
typedef Elements::size_type	size_type

Public Member Functions
	BSLMF_NESTED_TRAIT_DECLARATION (JsonArray, bslma::UsesBslmaAllocator)
	BSLMF_NESTED_TRAIT_DECLARATION (JsonArray, bslmf::IsBitwiseMoveable)
	BSLMF_NESTED_TRAIT_DECLARATION (JsonArray, bdlb::HasPrintMethod)
	JsonArray ()
	JsonArray (bslma::Allocator *basicAllocator)
	JsonArray (const JsonArray &original, bslma::Allocator *basicAllocator=0)
	JsonArray (bslmf::MovableRef< JsonArray > original) BSLS_KEYWORD_NOEXCEPT
	JsonArray (bslmf::MovableRef< JsonArray > original, bslma::Allocator *basicAllocator)
template<class t_INPUT_ITERATOR >
	JsonArray (t_INPUT_ITERATOR first, t_INPUT_ITERATOR last, bslma::Allocator *basicAllocator=0)
JsonArray &	operator= (const JsonArray &rhs)
JsonArray &	operator= (bslmf::MovableRef< JsonArray > rhs)
Json &	operator[] (bsl::size_t index)
template<class t_INPUT_ITERATOR >
JsonArray &	assign (t_INPUT_ITERATOR first, t_INPUT_ITERATOR last)
Iterator	begin ()
Iterator	end ()
Json &	front ()
Json &	back ()
void	clear ()
Iterator	erase (bsl::size_t index)
Iterator	erase (ConstIterator position)
Iterator	erase (ConstIterator first, ConstIterator last)
template<class t_INDEX >
bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, Iterator >::type	insert (t_INDEX index, const Json &json)
template<class t_INDEX >
bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, Iterator >::type	insert (t_INDEX index, bslmf::MovableRef< Json > json)
template<class t_INDEX , class t_INPUT_ITERATOR >
bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, Iterator >::type	insert (t_INDEX index, t_INPUT_ITERATOR first, t_INPUT_ITERATOR last)
Iterator	insert (ConstIterator position, const Json &json)
Iterator	insert (ConstIterator position, bslmf::MovableRef< Json > json)
template<class t_INPUT_ITERATOR >
Iterator	insert (ConstIterator position, t_INPUT_ITERATOR first, t_INPUT_ITERATOR last)
void	popBack ()
JsonArray &	pushBack (const Json &json)
JsonArray &	pushBack (const JsonArray &array)
JsonArray &	pushBack (const JsonObject &object)
JsonArray &	pushBack (const JsonNumber &number)
JsonArray &	pushBack (bslmf::MovableRef< Json > json)
JsonArray &	pushBack (bslmf::MovableRef< JsonArray > array)
JsonArray &	pushBack (bslmf::MovableRef< JsonObject > object)
JsonArray &	pushBack (bslmf::MovableRef< JsonNumber > number)
JsonArray &	pushBack (const JsonNull &value)
JsonArray &	pushBack (bool value)
JsonArray &	pushBack (int value)
JsonArray &	pushBack (unsigned int value)
JsonArray &	pushBack (long value)
JsonArray &	pushBack (unsigned long value)
JsonArray &	pushBack (long long value)
JsonArray &	pushBack (unsigned long long value)
JsonArray &	pushBack (float value)
JsonArray &	pushBack (double value)
JsonArray &	pushBack (bdldfp::Decimal64 value)
JsonArray &	pushBack (const char *string)
JsonArray &	pushBack (const bsl::string_view &string)
template<class t_STRING_TYPE >
bsl::enable_if< bsl::is_same< t_STRING_TYPE, bsl::string >::value, JsonArray & >::type	pushBack (BSLMF_MOVABLEREF_DEDUCE(t_STRING_TYPE) string)
void	resize (bsl::size_t count)
void	resize (bsl::size_t count, const Json &json)
void	swap (JsonArray &other)
const Json &	operator[] (bsl::size_t index) const
ConstIterator	begin () const BSLS_KEYWORD_NOEXCEPT
ConstIterator	cbegin () const BSLS_KEYWORD_NOEXCEPT
ConstIterator	end () const BSLS_KEYWORD_NOEXCEPT
ConstIterator	cend () const BSLS_KEYWORD_NOEXCEPT
const Json &	front () const
const Json &	back () const
bool	empty () const
bsl::size_t	size () const
bslma::Allocator *	allocator () const BSLS_KEYWORD_NOEXCEPT
bsl::size_t	maxSize () const BSLS_KEYWORD_NOEXCEPT
bsl::ostream &	print (bsl::ostream &stream, int level=0, int spacesPerLevel=4) const

Friends
bool	operator== (const JsonArray &, const JsonArray &)
bool	operator!= (const JsonArray &, const JsonArray &)
void	swap (JsonArray &, JsonArray &)

Member Typedef Documentation

const_iterator

typedef Elements::const_iterator bdljsn::JsonArray::const_iterator

const_reference

typedef Elements::const_reference bdljsn::JsonArray::const_reference

ConstIterator

typedef Elements::const_iterator bdljsn::JsonArray::ConstIterator

difference_type

typedef Elements::difference_type bdljsn::JsonArray::difference_type

Iterator

typedef Elements::iterator bdljsn::JsonArray::Iterator

iterator

typedef Elements::iterator bdljsn::JsonArray::iterator

reference

typedef Elements::reference bdljsn::JsonArray::reference

size_type

typedef Elements::size_type bdljsn::JsonArray::size_type

value_type

typedef Elements::value_type bdljsn::JsonArray::value_type

Constructor & Destructor Documentation

JsonArray() [1/6]

bdljsn::JsonArray::JsonArray ( )

inline

Create an empty JsonArray. Optionally specify a basicAllocator used to supply memory. If basicAllocator is not specified, the currently installed default allocator is used.

JsonArray() [2/6]

bdljsn::JsonArray::JsonArray ( bslma::Allocator *  basicAllocator )

inlineexplicit

JsonArray() [3/6]

bdljsn::JsonArray::JsonArray ( const JsonArray &  original, bslma::Allocator *  basicAllocator = 0  )

inline

Create a JsonArray having the same value as the specified original object. Optionally specify basicAllocator to supply memory. If basicAllocator is not specified, the allocator associated with original is propagated for use in the newly-created JsonArray.

JsonArray() [4/6]

bdljsn::JsonArray::JsonArray ( bslmf::MovableRef< JsonArray >  original )

inline

Create a JsonArray having the same value as the specified original object by moving (in constant time) the contents of original to the new JsonArray object. The allocator associated with original is propagated for use in the newly-created JsonArray object. original is left in a valid but unspecified state.

JsonArray() [5/6]

bdljsn::JsonArray::JsonArray ( bslmf::MovableRef< JsonArray >  original, bslma::Allocator *  basicAllocator  )

inline

Create a JsonArray having the same value as the specified original object that uses the specified basicAllocator to supply memory. The contents of original are moved (in constant time) to the new JsonArray object if basicAllocator == original.allocator(), and are move-inserted (in linear time) using basicAllocator otherwise. original is left in a valid but unspecified state.

JsonArray() [6/6]

template<class t_INPUT_ITERATOR >

bdljsn::JsonArray::JsonArray ( t_INPUT_ITERATOR  first, t_INPUT_ITERATOR  last, bslma::Allocator *  basicAllocator = 0  )

inline

Create a JsonArray and insert (in order) each Json object in the range starting at the specified first element, and ending immediately before the specified last element. Optionally specify basicAllocator used to supply memory. If basicAllocator is not specified, the currently installed default allocator is used. Throw bsl::length_error if the number of elements in [first .. last) exceeds the value returned by the method maxSize. The (template parameter) type t_INPUT_ITERATOR shall meet the requirements of an input iterator defined in the c++11 standard [24.2.3] providing access to values of a type convertible to Json, and Json must be emplace-constructible form *i, where i is a dereferenceable iterator in the range [first .. last).

Precondition

The behavior is undefined unless first and last refer to a range of valid values where first is at a position at or before last.

Member Function Documentation

allocator()

bslma::Allocator * bdljsn::JsonArray::allocator ( ) const

inline

Return the allocator used by this object to allocate memory.

assign()

template<class t_INPUT_ITERATOR >

JsonArray & bdljsn::JsonArray::assign ( t_INPUT_ITERATOR  first, t_INPUT_ITERATOR  last  )

inline

Assign to this object the value resulting from first clearing this JsonArray and then inserting (in order) each Json object in the range starting at the specified first element, and ending immediately before the specified last element. Return a non-const reference to this array. If an exception is thrown, *this is left in a valid but unspecified state. Throw bsl::length_error if distance(first,last) > maxSize(). The (template parameter) type t_INPUT_ITERATOR shall meet the requirements of an input iterator defined in the c++11 standard [24.2.3] providing access to values of a type convertible to Json, and Json must be emplace-constructible form *i, where i is a dereferenceable iterator in the range [first .. last).

Precondition

The behavior is undefined unless first and last refer to a range of valid values where first is at a position at or before last.

back() [1/2]

Json & bdljsn::JsonArray::back ( )

inline

Return a reference providing modifiable access to the last element in this JsonArray.

Precondition

The behavior is undefined unless this JsonArray is not empty.

back() [2/2]

const Json & bdljsn::JsonArray::back ( ) const

inline

Return a reference providing non-modifiable access to the last element in this JsonArray.

Precondition

The behavior is undefined unless this JsonArray is not empty.

begin() [1/2]

JsonArray::Iterator bdljsn::JsonArray::begin ( )

inline

Return an iterator providing modifiable access to the first element in this JsonArray, or the past-the-end iterator if this JsonArray is empty.

begin() [2/2]

JsonArray::ConstIterator bdljsn::JsonArray::begin ( ) const

inline

BSLMF_NESTED_TRAIT_DECLARATION() [1/3]

bdljsn::JsonArray::BSLMF_NESTED_TRAIT_DECLARATION	(	JsonArray	,
		bdlb::HasPrintMethod
	)

BSLMF_NESTED_TRAIT_DECLARATION() [2/3]

bdljsn::JsonArray::BSLMF_NESTED_TRAIT_DECLARATION	(	JsonArray	,
		bslma::UsesBslmaAllocator
	)

BSLMF_NESTED_TRAIT_DECLARATION() [3/3]

bdljsn::JsonArray::BSLMF_NESTED_TRAIT_DECLARATION	(	JsonArray	,
		bslmf::IsBitwiseMoveable
	)

cbegin()

JsonArray::ConstIterator bdljsn::JsonArray::cbegin ( ) const

inline

Return an iterator providing non-modifiable access to the first element in this JsonArray, and the past-the-end iterator if this JsonArray is empty.

cend()

JsonArray::ConstIterator bdljsn::JsonArray::cend ( ) const

inline

Return the past-the-end iterator providing non-modifiable access to this JsonArray.

clear()

void bdljsn::JsonArray::clear ( )

inline

Remove all elements from this JsonArray making its size 0.

Note

Note that although this JsonArray is empty after this method returns, it preserves the same capacity it had before the method was called.

empty()

bool bdljsn::JsonArray::empty ( ) const

inline

Return true if this JsonArray has size 0, and false otherwise.

end() [1/2]

JsonArray::Iterator bdljsn::JsonArray::end ( )

inline

Return the past-the-end iterator providing modifiable access to this JsonArray.

end() [2/2]

JsonArray::ConstIterator bdljsn::JsonArray::end ( ) const

inline

erase() [1/3]

JsonArray::Iterator bdljsn::JsonArray::erase ( bsl::size_t  index )

inline

Remove from this JsonArray the element at the specified index, and return an iterator providing modifiable access to the element immediately following the removed element, or the position returned by the method end if the removed element was the last in the sequence.

Precondition

The behavior is undefined unless index is in the range [0 .. size()).

erase() [2/3]

JsonArray::Iterator bdljsn::JsonArray::erase ( ConstIterator  first, ConstIterator  last  )

inline

Remove from this JsonArray the sequence of elements starting at the specified first position and ending before the specified last position, and return an iterator providing modifiable access to the element immediately following the last removed element, or the position returned by the method end if the removed elements were last in the sequence.

Precondition

The behavior is undefined unless first is an iterator in the range [cbegin() .. cend()] (both endpoints included) and last is an iterator in the range [first .. cend()] (both endpoints included).

erase() [3/3]

JsonArray::Iterator bdljsn::JsonArray::erase ( ConstIterator  position )

inline

Remove from this JsonArray the element at the specified position, and return an iterator providing modifiable access to the element immediately following the removed element, or the position returned by the method end if the removed element was the last in the sequence.

Precondition

The behavior is undefined unless position is an iterator in the range [cbegin() .. cend()).

front() [1/2]

Json & bdljsn::JsonArray::front ( )

inline

Return a reference providing modifiable access to the first element in this JsonArray.

Precondition

The behavior is undefined unless this JsonArray is not empty.

front() [2/2]

const Json & bdljsn::JsonArray::front ( ) const

inline

Return a reference providing non-modifiable access to the first element in this JsonArray.

Precondition

The behavior is undefined unless this JsonArray is not empty.

insert() [1/6]

JsonArray::Iterator bdljsn::JsonArray::insert ( ConstIterator  position, bslmf::MovableRef< Json >  json  )

inline

Insert at the specified position in this JsonArray the specified move-insertable json, and return an iterator referring to the newly inserted element. json is left in a valid but unspecified state. If an exception is thrown, this is unaffected. Throw bsl::length_error if size() == maxSize().

Precondition

The behavior is undefined unless position is an iterator in the range [begin() .. end()] (both endpoints included).

insert() [2/6]

JsonArray::Iterator bdljsn::JsonArray::insert ( ConstIterator  position, const Json &  json  )

inline

Insert at the specified position in this JsonArray a copy of the specified json, and return an iterator referring to the newly inserted element. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize().

Precondition

The behavior is undefined unless position is an iterator in the range [begin() .. end()] (both endpoints included).

insert() [3/6]

template<class t_INPUT_ITERATOR >

JsonArray::Iterator bdljsn::JsonArray::insert ( ConstIterator  position, t_INPUT_ITERATOR  first, t_INPUT_ITERATOR  last  )

inline

Insert at the specified position in this JsonArray the values in the range starting at the specified first element, and ending immediately before the specified last element. Return an iterator referring to the first newly inserted element. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() + distance(first, last) > maxSize(). The (template parameter) type t_INPUT_ITERATOR shall meet the requirements of an input iterator defined in the C++11 standard [24.2.3] providing access to values of a type convertible to value_type, and value_type must be emplace-constructible from *i into this JsonArray, where i is a dereferenceable iterator in the range [first .. last).

Precondition

The behavior is undefined unless position is an iterator in the range [begin() .. end()] (both endpoints included), and first and last refer to a range of valid values where first is at a position at or before last.

insert() [4/6]

template<class t_INDEX >

bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, JsonArray::Iterator >::type bdljsn::JsonArray::insert ( t_INDEX  index, bslmf::MovableRef< Json >  json  )

inline

Insert at the specified index in this JsonArray the specified move-insertable json, and return an iterator referring to the newly inserted element. json is left in a valid but unspecified state. If an exception is thrown, this is unaffected. Throw bsl::length_error if size() == maxSize(). The (template parameter) type t_INDEX must be a non-bool integral type.

Precondition

The behavior is undefined unless index is in the range [0 .. size()] (both endpoints included).

insert() [5/6]

template<class t_INDEX >

bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, JsonArray::Iterator >::type bdljsn::JsonArray::insert ( t_INDEX  index, const Json &  json  )

inline

Insert at the specified index in this JsonArray a copy of the specified json, and return an iterator referring to the newly inserted element. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize(). The (template parameter) type t_INDEX must be a non-bool integral type.

Precondition

The behavior is undefined unless index is in the range [0 .. size()].

insert() [6/6]

template<class t_INDEX , class t_INPUT_ITERATOR >

bsl::enable_if< bsl::is_integral< t_INDEX >::value &&!bsl::is_same< t_INDEX, bool >::value, JsonArray::Iterator >::type bdljsn::JsonArray::insert ( t_INDEX  index, t_INPUT_ITERATOR  first, t_INPUT_ITERATOR  last  )

inline

Insert at the specified index in this JsonArray the values in the range starting at the specified first element, and ending immediately before the specified last element. Return an iterator referring to the first newly inserted element. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() + distance(first, last) > maxSize(). The (template parameter) type t_INDEX must be a non-bool integral type. The (template parameter) type t_INPUT_ITERATOR shall meet the requirements of an input iterator defined in the C++11 standard [24.2.3] providing access to values of a type convertible to Json, and Json must be emplace-constructible from *i into this JsonArray, where i is a dereferenceable iterator in the range [first .. last).

Precondition

The behavior is undefined unless index is in the range [0 .. size()] (both endpoints included), and first and last refer to a range of valid values where first is at a position at or before last.

maxSize()

bsl::size_t bdljsn::JsonArray::maxSize ( ) const

inline

Return a theoretical upper bound on the largest number of elements that this JsonArray could possibly hold. Requests to create a JsonArray longer than this number of elements are guaranteed to raise a bsl::length_error exception.

Note

Note that there is no guarantee that the JsonArray can successfully grow to the returned size, or even close to that size, without running out of resources.

operator=() [1/2]

JsonArray & bdljsn::JsonArray::operator= ( bslmf::MovableRef< JsonArray >  rhs )

inline

Assign to this object the value of the specified rhs object, and return a reference providing modifiable access to this object. The contents of rhs are moved (in constant time) to this JsonArray if allocator() == rhs.allocator(); otherwise, all elements in this JsonArray are either destroyed or move-assigned to and each additional element in rhs is move-inserted into this JsonArray. rhs is left in a valid but unspecified state.

operator=() [2/2]

JsonArray & bdljsn::JsonArray::operator= ( const JsonArray &  rhs )

inline

Assign to this object the value of the specified rhs object, and return a reference providing modifiable access to this object. If an exception is thrown, *this is left in a valid but unspecified state.

operator[]() [1/2]

Json & bdljsn::JsonArray::operator[] ( bsl::size_t  index )

inline

Return a reference providing modifiable access to the element at the specified index in this JsonArray.

Precondition

The behavior is undefined unless index < size().

operator[]() [2/2]

const Json & bdljsn::JsonArray::operator[] ( bsl::size_t  index ) const

inline

Return a reference providing non-modifiable access to the element at the specified index in this JsonArray.

Precondition

The behavior is undefined unless index < size().

popBack()

void bdljsn::JsonArray::popBack ( )

inline

Erase the last element from this JsonArray.

Precondition

The behavior is undefined if this JsonArray is empty.

print()

bsl::ostream & bdljsn::JsonArray::print	(	bsl::ostream &	stream,
		int	level = 0,
		int	spacesPerLevel = 4
	)		const

Write the value of this object to the specified output stream in a human-readable format, and return a reference to stream. Optionally specify an initial indentation level, whose absolute value is incremented recursively for nested objects. If level is specified, optionally specify spacesPerLevel, whose absolute value indicates the number of spaces per indentation level for this and all of its nested objects. If level is negative, suppress indentation of the first line. If spacesPerLevel is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by level). If stream is not valid on entry, this operation has no effect.

Note

Note that this human-readable format is not fully specified, and can change without notice.

pushBack() [1/22]

JsonArray & bdljsn::JsonArray::pushBack ( bdldfp::Decimal64  value )

inline

pushBack() [2/22]

JsonArray & bdljsn::JsonArray::pushBack ( bool  value )

inline

pushBack() [3/22]

JsonArray & bdljsn::JsonArray::pushBack ( bslmf::MovableRef< Json >  json )

inline

Append to the end of this JsonArray the specified move-insertable json/array/object/number and return a non-const reference to this array. json/array/object/number is left in a valid but unspecified state. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize().

pushBack() [4/22]

JsonArray & bdljsn::JsonArray::pushBack ( bslmf::MovableRef< JsonArray >  array )

inline

pushBack() [5/22]

JsonArray & bdljsn::JsonArray::pushBack ( bslmf::MovableRef< JsonNumber >  number )

inline

pushBack() [6/22]

JsonArray & bdljsn::JsonArray::pushBack ( bslmf::MovableRef< JsonObject >  object )

inline

pushBack() [7/22]

template<class t_STRING_TYPE >

bsl::enable_if< bsl::is_same< t_STRING_TYPE, bsl::string >::value, JsonArray & >::type bdljsn::JsonArray::pushBack ( BSLMF_MOVABLEREF_DEDUCE(t_STRING_TYPE)  string )

inline

Append to the end of this JsonArray an element having the value of the specified string by moving (in constant time) the contents of string to the new element and return a non-const reference to this array. string is left in a valid but unspecified state. This function does not participate in overload resolution unless the specified t_STRING_TYPE is bsl::string.

Precondition

The behavior is undefined unless string is valid UTF-8 (see bdlde::Utf8Util::isValid).

pushBack() [8/22]

JsonArray & bdljsn::JsonArray::pushBack ( const bsl::string_view &  string )

inline

pushBack() [9/22]

JsonArray & bdljsn::JsonArray::pushBack ( const char *  string )

inline

Append to the end of this JsonArray a copy of the specified string and return a non-const reference to this array. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize().

pushBack() [10/22]

JsonArray & bdljsn::JsonArray::pushBack ( const Json &  json )

inline

Append to the end of this JsonArray a copy of the specified json/array/object/number and return a non-const reference to this array. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize().

pushBack() [11/22]

JsonArray & bdljsn::JsonArray::pushBack ( const JsonArray &  array )

inline

pushBack() [12/22]

JsonArray & bdljsn::JsonArray::pushBack ( const JsonNull &  value )

inline

Append to the end of this JsonArray a copy of the specified value and return a non-const reference to this array. If an exception is thrown, *this is unaffected. Throw bsl::length_error if size() == maxSize().

pushBack() [13/22]

JsonArray & bdljsn::JsonArray::pushBack ( const JsonNumber &  number )

inline

pushBack() [14/22]

JsonArray & bdljsn::JsonArray::pushBack ( const JsonObject &  object )

inline

pushBack() [15/22]

JsonArray & bdljsn::JsonArray::pushBack ( double  value )

inline

pushBack() [16/22]

JsonArray & bdljsn::JsonArray::pushBack ( float  value )

inline

pushBack() [17/22]

JsonArray & bdljsn::JsonArray::pushBack ( int  value )

inline

pushBack() [18/22]

JsonArray & bdljsn::JsonArray::pushBack ( long long  value )

inline

pushBack() [19/22]

JsonArray & bdljsn::JsonArray::pushBack ( long  value )

inline

pushBack() [20/22]

JsonArray & bdljsn::JsonArray::pushBack ( unsigned int  value )

inline

pushBack() [21/22]

JsonArray & bdljsn::JsonArray::pushBack ( unsigned long long  value )

inline

pushBack() [22/22]

JsonArray & bdljsn::JsonArray::pushBack ( unsigned long  value )

inline

resize() [1/2]

void bdljsn::JsonArray::resize ( bsl::size_t  count )

inline

Change the size of this JsonArray to the specified count. If count < size(), the elements in the range [count .. size()) are erased, and this function does not throw. If count > size(), the (newly created) elements in the range [size() .. count) are default-constructed Json objects, and if an exception is thrown, *this is unaffected. Throw bsl::length_error if count > maxSize().

resize() [2/2]

void bdljsn::JsonArray::resize ( bsl::size_t  count, const Json &  json  )

inline

Change the size of this JsonArray to the specified count, inserting copies of the specified json at the end if count > size(). If count < size(), the elements in the range [count .. size()) are erased json is ignored, and this method does not throw. If count > size() and an exception is thrown, *this is unaffected. Throw bsl::length_error if count > maxSize().

size()

bsl::size_t bdljsn::JsonArray::size ( ) const

inline

Return the number of elements in this JsonArray.

swap()

void bdljsn::JsonArray::swap ( JsonArray &  other )

inline

Exchange the value of this object with that of the specified other object. If an exception is thrown, both objects are left in valid but unspecified states. This operation guarantees O[1] complexity.

Precondition

The behavior is undefined unless this object was created with the same allocator as other.

Friends And Related Symbol Documentation

operator!=

bool operator!= ( const JsonArray &  , const JsonArray &    )

friend

Return false if the specified lhs and rhs objects have the same value, and true otherwise. Two JsonArray objects lhs and rhs have the same value if they have the same number of elements, and each element in the ordered sequence of elements of lhs has the same value as the corresponding element in the ordered sequence of elements of rhs.

operator==

bool operator== ( const JsonArray &  , const JsonArray &    )

friend

Return true if the specified lhs and rhs objects have the same value, and false otherwise. Two JsonArray objects lhs and rhs have the same value if they have the same number of elements, and each element in the ordered sequence of elements of lhs has the same value as the corresponding element in the ordered sequence of elements of rhs.

swap

void swap ( JsonArray &  , JsonArray &    )

friend

Exchange the value of the specified a JsonArray with that of the specified b JsonArray. This function provides the no-throw exception-safety guarantee. This operation has O[1] complexity if a was created with the same allocator as b; otherwise, it has O[n+m] complexity, where n and m are the number of elements in a and b, respectively.

---

The documentation for this class was generated from the following file:

• bdljsn_json.h