long modify(string ck, string xArray, yArray, array3)
This method modifies the geographic data associated with the line identified by ck. The data provided in xArray, yArray, and optionally array3 completely replaces the data provided when the line was originally created. These arrays need not contain the same number of elements as the original line. (See method createLine for additional information about the preparation of these arrays.)
The following should be carefully noted:
- If the original line is composed of 2D points and array3 is not empty, the line feature will be changed to a line composed of 3D points, in addition to possible changes to its (x,y) locations.
- If the original line is composed of 3D points and array3 is empty, the line feature will be changed to a line composed of 2D points, in addition to possible changes in its (x,y) locations. (If the original line feature is also a track, it will no longer be one.)
- If the original 3D line feature is a track and array3 is not empty, any highlighting is cleared before the feature is modified.
The method returns 0 upon success, and returns error codes for the following conditions:
ck does not identify a line feature
The input arrays contain invalid coordinates
The input arrays contain less than two points
xArray and yArray are not all the same length
array3 is not empty, but is not the same length as xArray and yArray
A CSF error occurred when trying to modify the feature. (This should normally not occur, and would most likely indicate a corrupted map dataset.)