QgsFeature::setId improve documentation with a warning. fixes #44898

qgis · Sep 22, 2021 · 6562817 · 6562817
1 parent e6b3907
commit 6562817
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git a/python/core/auto_generated/qgsfeature.sip.in b/python/core/auto_generated/qgsfeature.sip.in
@@ -174,6 +174,12 @@ Sets the feature ``id`` for this feature.
 :param id: feature id
 
 .. seealso:: :py:func:`id`
+
+.. warning::
+
+   Feature IDs will be automatically changed whenever a feature is added to vector layer or data provider.
+   This method is not designed to allow a specific feature ID to be assigned to a feature which will be added to a
+   layer or data provider, and the results will be unpredictable
 %End
 
     QgsAttributes attributes() const;

diff --git a/src/core/qgsfeature.h b/src/core/qgsfeature.h
@@ -224,6 +224,9 @@ class CORE_EXPORT QgsFeature
      * Sets the feature \a id for this feature.
      * \param id feature id
      * \see id()
+     * \warning Feature IDs will be automatically changed whenever a feature is added to vector layer or data provider.
+     *  This method is not designed to allow a specific feature ID to be assigned to a feature which will be added to a
+     *  layer or data provider, and the results will be unpredictable
      */
     void setId( QgsFeatureId id );