SetDataVector()

Summary

Fills values into a field in a view|set from a vector.

 

Changes

Added to Version 6.0/2012.

 

Syntax

SetDataVector(string viewset, string field, vector v, array options)

 

Argument	Contents
viewset	The name of the view|set
field	The name of the field
v	A vector

 

Options	Type	Contents
Sort Order	Array	An array of arrays with two strings, the name of the field and "Ascending" or "Descending," for each field in the sort order

 

Notes

• SetDataVector() displays a progress bar when setting a large number of records. To add a Cancel button to the progress bar, precede the function call with an "on escape" clause. For more information, see Error Handling.

• An example of a Sort Order option: {{"Sort Order",{{Field1,"Ascending"},{Field2,"Descending"}}}}

• For more information on vectors, see Vectors.

Example

// First open customer.dbf in the Tutorial folder for exclusive access

// and modify the table to add an Integer field TotalSales of width 12

view_name = GetView()

v1 = GetDataVector(view_name+"|", "SALES", )

v2 = GetDataVector(view_name+"|", "LAST_YEAR", )

v3 = v1 + v2

SetDataVector(view_name+"|", "TotalSales", v3, )

RedrawEditor(view_name)

 

See Also

 

GISDK Function	Summary
ArrayToVector()	Copies an array to a vector
CopyVector()	Copies a vector to a new vector
CumulativeVector()	Constructs a cumulative vector in a new vector
ConcatenateVectors()	Concatenates vectors into one, combined long vector
GetDataVector()	Creates a vector from a field in a view|set
GetDataVectors()	Creates vectors from fields in a view|set
SetDataVectors()	Fills values into fields in a view|set from vectors
SortVector()	Sorts the elements of a vector in ascending order
SortVectors()	Sorts an array of vectors in ascending order, based on the first vector
TransposeArray()	Transposes an array of arrays, where element b[i][j] = a[j][i]
Vector()	Creates a vector
VectorStatistic()	Computes a given statistic for the vector
VectorToArray()	Copies a vector to an array