text: /*
   * Copyright (c) 2014, Ford Motor Company
   * All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions are met:
   *
   * Redistributions of source code must retain the above copyright notice, this
   * list of conditions and the following disclaimer.
   *
   * Redistributions in binary form must reproduce the above copyright notice,
   * this list of conditions and the following
   * disclaimer in the documentation and/or other materials provided with the
   * distribution.
   *
   * Neither the name of the Ford Motor Company nor the names of its contributors
   * may be used to endorse or promote products derived from this software
   * without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
   * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   * POSSIBILITY OF SUCH DAMAGE.
   */
  #ifndef SRC_COMPONENTS_SMART_OBJECTS_INCLUDE_SMART_OBJECTS_ARRAY_SCHEMA_ITEM_H_
  #define SRC_COMPONENTS_SMART_OBJECTS_INCLUDE_SMART_OBJECTS_ARRAY_SCHEMA_ITEM_H_
  
  #include <stddef.h>
  
  #include "smart_objects/schema_item.h"
  #include "smart_objects/always_true_schema_item.h"
  #include "smart_objects/schema_item_parameter.h"
  
  #include "utils/semantic_version.h"
  
  namespace ns_smart_device_link {
  namespace ns_smart_objects {
  /**
   * @brief Array schema item.
   **/
  class CArraySchemaItem : public ISchemaItem {
   public:
    /**
     * @brief Create a new schema item.
     *
     * @param ElementSchemaItem SchemaItem for array elements.
     * @param MinSize Minimum allowed size.
     * @param MaxSize Maximum allowed size.
     *
     * @return Shared pointer to a new schema item.
     **/
    static std::shared_ptr<CArraySchemaItem> create(
        const ISchemaItemPtr ElementSchemaItem = CAlwaysTrueSchemaItem::create(),
        const TSchemaItemParameter<size_t>& MinSize =
            TSchemaItemParameter<size_t>(),
        const TSchemaItemParameter<size_t>& MaxSize =
            TSchemaItemParameter<size_t>());
  
    /**
     * @brief Validate smart object.
     * @param Object Object to validate.
     * @param report__ object for reporting errors during validation
     * @param MessageVersion to check mobile RPC version against RPC Spec History
     * @return ns_smart_objects::errors::eType
     **/
    errors::eType validate(const SmartObject& Object,
                           rpc::ValidationReport* report__,
                           const utils::SemanticVersion& MessageVersion =
                               utils::SemanticVersion()) OVERRIDE;
  
    /**
     * @brief Apply schema.
     *
     * @param Object Object to apply schema.
     *
     * @param RemoveFakeParameters contains true if need to remove fake parameters
     * from smart object otherwise contains false.
     **/
    void applySchema(SmartObject& Object,
                     const bool RemoveFakeParameters,
                     const utils::SemanticVersion& MessageVersion =
                         utils::SemanticVersion()) OVERRIDE;
  
    /**
     * @brief Unapply schema.
     *
     * @param Object Object to unapply schema.
     **/
    void unapplySchema(SmartObject& Object) OVERRIDE;
  
    /**
     * @brief Build smart object by smart schema having copied matched
     *        parameters from pattern smart object
     *
     * @param pattern_object pattern object
     * @param result_object object to build
     */
    void BuildObjectBySchema(const SmartObject& pattern_object,
                             SmartObject& result_object) OVERRIDE;
  
   private:
    /**
     * @brief Constructor.
     *
     * @param ElementSchemaItem SchemaItem for array elements.
     * @param MinSize Minimum allowed size.
     * @param MaxSize Maximum allowed size.
     **/
    CArraySchemaItem(const ISchemaItemPtr ElementSchemaItem,
                     const TSchemaItemParameter<size_t>& MinSize,
                     const TSchemaItemParameter<size_t>& MaxSize);
    /**
     * @brief SchemaItem for array elements.
     **/
    const ISchemaItemPtr mElementSchemaItem;
    /**
     * @brief Minimum allowed size.
     **/
    const TSchemaItemParameter<size_t> mMinSize;
    /**
     * @brief Maximum allowed size.
     **/
    const TSchemaItemParameter<size_t> mMaxSize;
    DISALLOW_COPY_AND_ASSIGN(CArraySchemaItem);
  };
  }  // namespace ns_smart_objects
  }  // namespace ns_smart_device_link
  
  #endif  // SRC_COMPONENTS_SMART_OBJECTS_INCLUDE_SMART_OBJECTS_ARRAY_SCHEMA_ITEM_H_
  