Conversions
NIM's name generator provides a multitude of conversions that can be applied to name parts (e.g., first, middle, or last name). These conversions allow you to transform a name part by adding or removing characters, changing casing, and more. The list below details the currently available conversions, their usage, as well as examples of input and output.
- Add at begin Adds the value of
Argument 1to the beginning of the name part. - Argument 1: Value to add - Argument 2: n/a - Add at begin if not empty Adds the value of
Argument 1to the beginning of the name part, provided the name part is not empty. If the name part is empty, nothing is added. - Argument 1: Value to add - Argument 2: n/a - Add at end if empty Adds the value of
Argument 1to the end of the name part, provided the name part is empty. If the name part is not empty, nothing is added. - Argument 1: Value to add - Argument 2: n/a - Add at end Adds the value of
Argument 1to the end of the name part. - Argument 1: Value to add - Argument 2: n/a - Add at end if not empty Adds the value of
Argument 1to the end of the name part, provided the name part is not empty. If the name part is empty, nothing is added. - Argument 1: Value to add - Argument 2: n/a - Add at end if not found Adds the value of
Argument 1to the end of the name part if the value ofArgument 2is not found in that name part. If the value ofArgument 2is present in the name part, nothing is added. - Argument 1: Value to add - Argument 2: Search value - Add blank at begin Adds a single blank space to the beginning of the name part. - Argument 1: n/a - Argument 2: n/a
- Add blank at begin if not empty Adds a single blank space to the beginning of the name part, provided the name part is not empty. If it is empty, nothing is added. - Argument 1: n/a - Argument 2: n/a
- Add blank at end Adds a single blank space to the end of the name part. - Argument 1: n/a - Argument 2: n/a
- Add blank at end if not empty Adds a single blank space to the end of the name part, provided the name part is not empty. If it is empty, nothing is added. - Argument 1: n/a - Argument 2: n/a
- Add char until length reached Adds the string value of
Argument 1to the end name part until the length of the name part is equal to the integer value provided inArgument 2. If the length of the name part is already equal or greater to the value inArgument 2, nothing is added. - Argument 1: String to add to the name - Argument 2: Minimum length of the name part (integer) - Case conversion: convert to lower case Converts every character in the name part to lowercase. "A" becomes "a", "B" becomes "b", and so on. - Argument 1: n/a - Argument 2: n/a
- Case conversion: convert first N chars to lower case Converts the number of characters defined in
Argument 1, beginning at the start of the string, to lowercase. The rest of the name part is not modified. - Argument 1: The number (integer) of character to convert to lowercase - Argument 2: n/a - Case conversion: convert last N chars to lower case Converts the number of characters defined in
Argument 1, counting back from the end the name part, to lowercase. The rest of the name part is not modified. - Argument 1: The number (integer) of character to convert to lowercase - Argument 2: n/a - Case conversion: convert to upper case Converts every character in the name part to uppercase. "a" becomes "A", "b" becomes "B", and so on. - Argument 1: n/a - Argument 2: n/a
- Case conversion: convert first N chars to upper case Converts the number of characters defined in
Argument 1, beginning at the start of the string, to uppercase. The rest of the name part is not modified. - Argument 1: The number (integer) of character to convert to uppercase - Argument 2: n/a - Case conversion: 1st upper, other unchanged Converts the first character of the name part to uppercase, but leaves the rest of the name part unmodified. - Argument 1: n/a - Argument 2: n/a
- Case conversion: 1st upper, other characters lower case Converts the first character of the name part to uppercase and converts every other character to lowercase. "AARON" becomes "Aaron", for example. - Argument 1: n/a - Argument 2: n/a
- Case conversion: convert last N chars to upper case Converts the number of characters defined in
Argument 1, counting back from the end the name part, to lowercase. The rest of the name part is not modified. - Argument 1: The number (integer) of character to convert to lowercase - Argument 2: n/a - Conversion: start with text Adds the value of
Argument 1to the beginning of the name part. - Argument 1: Value to add - Argument 2: n/a - Conversion: end with text Adds the value of
Argument 1to the end of the name part. - Argument 1: Value to add - Argument 2: n/a - Conversion remove diacritical marks Replaces characters that have diacritical (accent) marks with their unaccented counterparts. For example, "é" becomes "e", "ñ" becomes "n" and so on. - Argument 1: n/a - Argument 2: n/a
- Conversion: reverse all characters Reverses all characters in a name part. "Alex" becomes "xelA", for example. - Argument 1: n/a - Argument 2: n/a
- Delete: all blank characters Removes all blank characters from a name part. These can be spaces, tab characters, or other whitespace characters. - Argument 1: n/a - Argument 2: n/a
- Delete: all non blank characters Removes all non-blank characters from a string, including letters, numbers, and symbols. It will retain only the blank characters such as spaces, tab characters, or other whitespace characters. - Argument 1: n/a - Argument 2: n/a
- Delete all matching characters Removes all instances of the characters in
Argument 1from the name part. The search is case-insensitive. Each character (which can be a letter, number, symbol, or whitespace) need only be supplied to the argument once to have every instance of it removed from the name part. Multiple characters can be provided. For example, providing "cil" as the argument would turn "Alicia" into "Aa" - Argument 1: The character(s) you want to have removed from the name part - Argument 2: n/a - Delete all but the matching characters Removes every character in a name part except those provided to
Argument 1. The search is case-insensitive. Multiple characters can be provided. For example, providing "ar" would turn "Aaron" into "Aar". - Argument 1: The character(s) you want to preserve in the name part - Argument 2: n/a - Delete all matching UTF-8 characters. Example: 26,3b,6a Removes the characters that match the UTF-8 hex codes provided in
Argument 1. The search is case-insensitive, so codes for a capital letter will also match a lower case letter. Multiple character codes can be provided by separating them with a comma. For example, providing the code "41" (the capital letter A) will match both "A" and "a", and turn "Aaron" into "ron". - Argument 1: A comma-separated list of the UTF-8 character hex codes you want to remove from the name part - Argument 2: n/a - Delete all but the matching UTF-8 characters Removes all characters except those whose UTF-8 hex code is provided in Argument 1. The search is case-insensitive, so codes for a capital letter will also match a lower case letter. Multiple character codes can be provided by separating them with a comma. For example, providing the code "41" (the capital letter A) will match both "A" and "a", and turn "Aaron" into "Aa". - Argument 1: A comma-separated list of the UTF-8 character hex codes you want to keep in the name part. Everything else will be removed. - Argument 2: n/a
- Delete first N characters Removes the number of characters from the start of the name part as specified by
Argument 1. - Argument 1: The number (integer) of characters to remove from the start name part - Argument 2: n/a - Delete last N characters Removes a number of characters, starting from the end of the name part, as specified by
Argument 1. - Argument 1: The number (integer) of characters to remove from the end of the name part - Argument 2: n/a - Delete substring Removes the string provided in
Argument 1from the name part. The search is case-insensitive. For example, providing "ro" would turn "Aaron" into "Aan". - Argument 1: The substring to remove from the name part - Argument 2: n/a - Delete substring (case sensitive) Removes the string provided in
Argument 1from the name part. The search is case-sensitive. For example, providing "Abc" would turn "AbcAbCABC" into "AbCABC" (only the first matching instance of "Abc" would be removed). - Argument 1: The substring to remove from the name part - Argument 2: n/a - Delete leading blank characters Removes white space characters from the start of the name part, such as spaces and tab characters. - Argument 1: n/a - Argument 2: n/a
- Delete trailing blank characters Removes white space characters from the end of the name part, such as spaces and tab characters. - Argument 1: n/a - Argument 2: n/a
- Insert after every character Inserts the character(s) presented in
Argument 1after each character in the name part. For example, providing "." as the argument would turn "Aaron" into "A.a.r.o.n." - Argument 1: The character(s) you want to add after each character in the name part - Argument 2: n/a - Replace argument1 by argument2 Replaces each character in
Argument 1with the character(s) present inArgument 2. The search is case-insensitive, and multiple characters can be supplied for each argument. For example, providing "rn" inArgument 1and "x" inArgument 2would turn "Aaron" into "Aaxox" - Argument 1: The character(s) you want to replace with the value ofArgument 2- Argument 2: The character(s) you want to put into the name part - Replace substring if ends with substring (case insensitive) Replaces the substring specified in
Argument 1with the value ofArgument 2, only if the name part ends withArgument 1. The comparison is case-insensitive. This is particularly useful for modifying email domains. For example, providing "gmail.com" asArgument 1and "mydomain.com" asArgument 2will change "johndoe@gmail.com" to "johndoe@mydomain.com". - Argument 1: The substring to match at the end of the name part (case-insensitive) - Argument 2: The value that replacesArgument 1when a match is found - Shorten: use first character Shortens the name part to its first character. It is recommended to remove leading white space before using this conversion to avoid having a blank space be the end result. - Argument 1: n/a - Argument 2: n/a
- Shorten: user first character of each part Shortens the name part to the first character of each of its given parts. The parts are defined as being separated by dashes or spaces. Additional characters such as commas are also removed. For example, "Lee, Harding" would be shortened to "LH". - Argument 1: n/a - Argument 2: n/a
- Shorten: convert to first N characters Shortens the name part to the number of characters specified in
Argument 1. - Argument 1: The number (integer) of characters to keep from the start of the name part - Argument 2: n/a - Shorten: convert to last N characters Shortens the name part to the last N characters of the name part, as specified in
Argument 1. - Argument 1: The number (integer) of characters to keep from the end of the name part - Argument 2: n/a - Shorten: remove after first matching character Removes all characters from a name part after the first instance of the character specified in
Argument 1. This is particularly useful for shortening multi-part last names when a shorter username is desired. For example, providing a dash (-) toArgument 1would shorten "Harrison-Welles" to "Harrison-". It is recommended that you pair this up with a Delete Substring or Delete Last N Character method to get rid of the left-behind character. - Argument 1: The character after whose first instance everything else will be removed from the name part - Argument 2: n/a - Shorten: remove after last matching character Removes all characters from a name part after the last instance of the character specified in
Argument 1. For example, providing a space toArgument 1would shorten "Dominic Hazel Jr." to "Dominic Hazel ". It is recommended that you pair this up with a Delete Substring or Delete Last N Character method to get rid of the left-behind character. - Argument 1: The character after whose last instance everything else will be removed from the name part - Argument 2: n/a - Shorten: remove after matching text (case insensitive) Removes all characters from a name part that occur after the given string in
Argument 1. The search is case-insensitive. - Argument 1: The string to search for in the name part - Argument 2: n/a - Shorten: remove after matching text (case sensitive) Removes all characters from a name that occur after the given string in
Argument 1. The search is case-sensitive. - Argument 1: The string to search for in the name part - Argument 2: n/a - Shorten: remove before first matching character Removes all characters from a name part before the first instance of the character specified in
Argument 1. This is particularly useful for shortening multi-part last names when a shorter username is desired. For example, providing a dash (-) toArgument 1would shorten "Harrison-Welles" to "-Welles". It is recommended that you pair this up with a Delete Substring or Delete Last N Character method to get rid of the left-behind character. - Argument 1: The character whose first occurrence determines where the name part is shortened - Argument 2: n/a - Shorten: remove before last matching character Removes all characters from a name part before the last instance of the character specified in
Argument 1. This is particularly useful for shortening multi-part last names when a shorter username is desired, or for extracting the top level domain of a URL or email address. For example, providing a dot (.) toArgument 1would shorten "mydomain.k12.wa.gov" to ".gov" - Argument 1: The character whose last occurrence determines where the name part is shortened - Argument 2: n/a - Shorten: remove before matching text (case insensitive) Removes everything in the name part before the string provided in
Argument 1. The search is not case sensitive. The first match of the string, starting from the left-side of the name part, will determine where the name is shortened. Providing "A" toArgument 1would turn "Bailey, Aaron" into "ailey, Aaron". - Argument 1: The string to search for in the name part - Argument 2: n/a - Shorten: remove before matching text (case sensitive) Removes everything in the name part before the string provided in
Argument 1. The search is case sensitive. The first match of the string, starting from the left-side of the name part, will determine where the name is shortened. Providing "A" toArgument 1would turn "Bailey, Aaron" into "Aaron". - Argument 1: The string to search for in the name part - Argument 2: n/a - Shorten: limit total name length Truncates the name part so that the total length of the generated name does not exceed the value provided to
Argument 1. This conversion should be used on the last part of the name generator's method and before any parts that contain iterators. - Argument 1: The maximum number (integer) of characters allowed in the generated name, added up across all parts prior to and including the one that this conversion is placed on - Argument 2: n/a - Shorten: limit total name length (remove characters only) Truncates the name part so that the total length of the generated name does not exceed the value provided to
Argument 1. Numbers (such as an employee ID) are not truncated. This conversion should be used on the last part of the name generator's method and before any parts that contain iterators. - Argument 1: The maximum number (integer) of characters allowed in the generated name, added up across all parts prior to and including the one that this conversion is placed on - Argument 2: n/a - Shorten: remove after matching text (case insensitive) Removes everything in the name after before the string provided in
Argument 1. The search is not case sensitive. The first match of the string, starting from the left-side of the name part, will determine where the name is shortened. Providing a comma (,) toArgument 1would turn "Bailey, Aaron" into "Bailey,". - Argument 1: The string to search for in the name part - Argument 2: n/a