Changes between Version 6 and Version 7 of rfc35_deletereorderalterfielddefn

Timestamp:

May 8, 2011, 10:55:33 AM (13 years ago)

Author:

Even Rouault

Comment:

change meaning of map array

rfc35_deletereorderalterfielddefn

@@ -25 +25 @@
 {{{
     virtual OGRErr      DeleteField( int iField );
-    virtual OGRErr      ReorderFields( int* panNewOrder );
+    virtual OGRErr      ReorderFields( int* panMap );
     virtual OGRErr      AlterFieldDefn( int iField, OGRFieldDefn* poNewFieldDefn, int nFlags );
 
@@ -63 +63 @@
 
 /**
-\fn OGRErr OGRLayer::ReorderFields( int* panNewOrder );
+\fn OGRErr OGRLayer::ReorderFields( int* panMap );
 
 \brief Reorder all the fields of a layer.
@@ -75 +75 @@
 were obtained or created with the previous layer definition.
 
-For each field definition initially at position i, its new position
-will be panNewOrder[i].
+panMap is such that,for each field definition at position i after reordering,
+its position before reordering was panMap[i].
 
 For example, let suppose the fields were "0","1","2","3","4" initially.
-ReorderFields([0,3,1,2,4]) will reorder them as "0","2","3","1","4".
+ReorderFields([0,2,3,1,4]) will reorder them as "0","2","3","1","4".
 
 Not all drivers support this method. You can query a layer to check if it supports it
@@ -88 +88 @@
 This function is the same as the C function OGR_L_ReorderFields().
 
-@param panNewOrder an array of GetLayerDefn()->GetFieldCount() elements which
+@param panMap an array of GetLayerDefn()->GetFieldCount() elements which
 is a permutation of [0, GetLayerDefn()->GetFieldCount()-1].
 
@@ -182 +182 @@
 {{{
 OGRErr CPL_DLL OGR_L_DeleteField( OGRLayerH, int iField );
-OGRErr CPL_DLL OGR_L_ReorderFields( OGRLayerH, int* panNewOrder );
+OGRErr CPL_DLL OGR_L_ReorderFields( OGRLayerH, int* panMap );
 OGRErr CPL_DLL OGR_L_ReorderField( OGRLayerH, int iOldFieldPos, int iNewFieldPos );
 OGRErr CPL_DLL OGR_L_AlterFieldDefn( OGRLayerH, int iField, OGRFieldDefnH hNewFieldDefn, int nFlags );