size()

template<template< typename U, typename V, typename... Args > class ObjectType = std::map, template< typename U, typename... Args > class ArrayType = std::vector, class StringType = std::string, class BooleanType = bool, class NumberIntegerType = std::int64_t, class NumberUnsignedType = std::uint64_t, class NumberFloatType = double, template< typename U > class AllocatorType = std::allocator, template< typename T, typename SFINAE=void > class JSONSerializer = adl_serializer, class BinaryType = std::vector<std::uint8_t>>

size_type nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer, BinaryType >::size ( ) const

inlinenoexcept

returns the number of elements

Returns the number of elements in a JSON value.

Returns

The return value depends on the different types and is defined as follows:

Value type	return value
null	0
boolean	1
string	1
number	1
binary	1
object	result of function object_t::size()
array	result of function array_t::size()

@liveexample{The following code calls size() on the different value types.,size}

@complexity Constant, as long as array_t and object_t satisfy the Container concept; that is, their size() functions have constant complexity.

@iterators No changes.

@exceptionsafety No-throw guarantee: this function never throws exceptions.

Note

This function does not return the length of a string stored as JSON value - it returns the number of elements in the JSON value which is 1 in the case of a string.

@requirement This function helps basic_json satisfying the Container requirements:

• The complexity is constant.
• Has the semantics of std::distance(begin(), end()).

See also

see empty() – checks whether the container is empty

see max_size() – returns the maximal number of elements

Since

version 1.0.0

Definition at line 22912 of file json.hpp.

    {
        switch (m_type)
        {
            case value_t::null:
            {
                // null values are empty
                return 0;
            }
 
            case value_t::array:
            {
                // delegate call to array_t::size()
                return m_value.array->size();
            }
 
            case value_t::object:
            {
                // delegate call to object_t::size()
                return m_value.object->size();
            }
 
            case value_t::string:
            case value_t::boolean:
            case value_t::number_integer:
            case value_t::number_unsigned:
            case value_t::number_float:
            case value_t::binary:
            case value_t::discarded:
            default:
            {
                // all other types have size 1
                return 1;
            }
        }
    }