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 of
Argument 2Argument 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" as
Argument 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 replaces
Argument 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