Add delete layer method and tests in doc (#583)

Add `Dataset::delete_layer`

.github/workflows/ci.yml

@@ -25,7 +25,6 @@ jobs:
     strategy:
       matrix:
         version:
-          - latest # 3.10.0
           - 3.9.3
           - 3.8.5
           - 3.7.3

CHANGES.md

@@ -10,6 +10,7 @@
 
 ### Added
 
+  - Add `Dataset::delete_layer` ([#583](https://github.com/georust/gdal/pull/583))
   - Add a `bundled` feature for `gdal-sys` for building and statically linking a minimal bundled version of GDAL ([#517](https://github.com/georust/gdal/pull/517))
   - Add pre-built bindings for GDAL 3.10 ([#573](https://github.com/georust/gdal/pull/573))
   - Add methods `alternative_name`, `is_nullable`, `is_unique`, `default_value` to `Field` ([#561](https://github.com/georust/gdal/pull/561))

src/vector/layer.rs

@@ -728,6 +728,30 @@ impl Dataset {
         };
         Ok(self.child_layer(c_layer))
     }
+
+    /// Deletes the layer at given index
+    ///
+    /// ```
+    /// # use gdal::DriverManager;
+    /// # let driver = DriverManager::get_driver_by_name("GPKG").unwrap();
+    /// # let mut dataset = driver.create_vector_only("/vsimem/example.gpkg").unwrap();
+    /// let blank_layer = dataset.create_layer(Default::default()).unwrap();
+    /// assert!(dataset.delete_layer(1).is_err());
+    /// dataset.delete_layer(0).unwrap();
+    /// assert_eq!(dataset.layers().count(), 0);
+    /// ```
+    pub fn delete_layer(&mut self, idx: usize) -> Result<()> {
+        let idx = c_int::try_from(idx)?;
+        let err = unsafe { gdal_sys::GDALDatasetDeleteLayer(self.c_dataset(), idx) };
+        if err != OGRErr::OGRERR_NONE {
+            Err(GdalError::OgrError {
+                err,
+                method_name: "GDALDatasetDeleteLayer",
+            })
+        } else {
+            Ok(())
+        }
+    }
 }
 
 #[cfg(test)]