Update sip bindings

python/core/qgsvectorlayer.sip

@@ -372,6 +372,18 @@ class QgsVectorLayer : QgsMapLayer
      */
     QgsFeatureList selectedFeatures();
 
+    /**
+     * Get an iterator of the selected features
+     *
+     * @param request You may specify a request, e.g. to limit the set of requested attributes.
+     *                Any filter on the request will be discarded.
+     *
+     * @return Iterator over the selected features
+     *
+     * @see    selectedFeaturesIds()
+     */
+    QgsFeatureIterator selectedFeaturesIterator( QgsFeatureRequest request = QgsFeatureRequest() );
+
     /**
      * Return reference to identifiers of selected features
      *

src/core/qgsvectorlayer.cpp

@@ -2296,7 +2296,6 @@ const QgsFeatureIds& QgsVectorLayer::selectedFeaturesIds() const
   return mSelectedFeatureIds;
 }
 
-
 QgsFeatureList QgsVectorLayer::selectedFeatures()
 {
   QgsFeatureList features;

src/core/qgsvectorlayer.h

@@ -731,6 +731,7 @@ class CORE_EXPORT QgsVectorLayer : public QgsMapLayer
      * @return A list of { @link QgsFeature } 's
      *
      * @see    selectedFeaturesIds()
+     * @see    selectedFeaturesIterator() which is more memory friendly when handling large selections
      */
     QgsFeatureList selectedFeatures();
 
@@ -743,6 +744,7 @@ class CORE_EXPORT QgsVectorLayer : public QgsMapLayer
      * @return Iterator over the selected features
      *
      * @see    selectedFeaturesIds()
+     * @see    selectedFeatures()
      */
     QgsFeatureIterator selectedFeaturesIterator( QgsFeatureRequest request = QgsFeatureRequest() );