newsditerator - Constructor

Make a new, empty sditerator.

Synopsis
newsditerator(filename, type, lockoptions)

Description
Create a new, empty data set of the indicated type on disk and attach an sditerator to it. Currently, only flat-tables can be created. In the future, other types will be available.

Arguments

filename	in	Name of new data set on disk.
		Allowed:	String
type	in	The type of data set.
		Allowed:	String
		Default:	'Table'
lockoptions	in	locking to be used
		Allowed:	String
		Default:	auto

Returns
sditerator tool

Example

  sdit := sditerator("a302_SP",correcteddata=T);
  newit := newsditerator("a302_SP.copy");
  for (i in 1:sdit.length()) {
     newit.appendrec(sdit.get());
     sdit.next();
  }

This example shows how a new sditerator is created and sdrecords from a existing sditerator are copied to it. The first line opens the existing data set. The second line creates a new data set. The loop copies each record from the existing sditerator to the new one.

Next: sditfromsdit - Constructor Up: sditerator - Tool Previous: sditerator - Constructor Contents Index

	Package	dish
	Module	dish
	Tool	sditerator