Description
The Name macro is used to insert human names into strings generated with the Custom String generator.
The macro is an analog of the Name data generator.
Syntax
The macro has the following syntax:
Parameters
Gender
Optional parameter. Specifies the gender of names to be generated:
- Any - Default. Generates names of any gender - either male or female.
- Male - Generates male names only.
- Female - Generates female names only.
NameKind
Optional parameter. Specifies the type of names to be generated:
- Full - Default. Generates full names.
- First - Generates first names only.
- Last - Generates last names only.
*xN
Optional parameter. Specifies the number of possible repetitions of each value in series of generated strings. N is a positive number that specifies the number of repetitions: 1, 2, 3, and so on. The default parameter value is *x1 (no repetitions).
Examples
The following example demonstrates how to use the Name macro:
-
%NAME(Any, Full, *x3)
Generates full names of any gender and repeats each generated value three times.
-
%NAME(Male,First)
Generates only first male names.
-
%NAME(Female,*x2)
Generates full female names and repeats each generated value twice. Here the default value of the NameKind parameter is used - Full.
Remarks
-
For more information on adding macros to custom strings, see About Custom String Generator
-
For more information on general rules used for specifying macro parameters, see Custom String Generator Rules .
See Also
Macro Reference
Custom String Generator Rules
Custom String Generator
Name Generator
Using Data Generators
Generating Values