RecipeSelectNextRecipe() function

The RecipeSelectNextRecipe() function selects the next recipe in the recipe template file.

Category

Recipe

Syntax

RecipeSelectNextRecipe("Filename", "RecipeName", Number);

Arguments

FileName

Name of the recipe template file. The FileName argument can be a string constant or a message tag containing the name of the recipe template file.

RecipeName

Message tag that contains the recipe name to use as a starting point (before the function is executed) and the selected recipe name (after the function is executed). Actual message tag without quotation marks or a string literal.

Number

Maximum string length returned to the argument. In InTouch, string (message) tags have a maximum length of 131 characters. Use 131 for this parameter unless you have reduced the maximum string length of the InTouch tag. Number or integer tag.

Example

The following statement reads the current value of the tag RecipeName and returns the next recipe on file. If the value of RecipeName is blank or cannot be found, the first recipe on file is returned. If RecipeName currently contains the last Recipe Name on file, it is returned unchanged. Recipes are saved in the recipe template file in the order in which they are created.

RecipeSelectNextRecipe("c:\recipe\recfile.csv",
RecipeName, 131);