Cicode Programming Reference > Cicode Function Categories > String Functions Introduction > StrToGrp

StrToGrp

Converts a string into a group and places it into a group number. Any existing values in the group are cleared before the new values are inserted. The group string is a series of numbers separated by " , " to list individual values or " .. " to specify a range of values.

Syntax

StrToGrp(hGrp, Str)

hGrp:

The group handle, returned from the GrpOpen() function. The group handle identifies the table where all data on the associated group is stored.

Str:

The string to convert.

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

GrpOpen

Example

hGrp=GrpOpen("MyGrp",1);
! Set group to 1 ... 10 and 20, 30 and 40.
StrToGrp(hGrp,"1..10,20,30,40");

See Also

String Functions