Class StringExtensions
Extension methods for strings.
Assembly: Dalamud.dll
public static class StringExtensions
Methods
Format(string, params object[])
An extension method to chain usage of string.Format.
public static string Format(this string format, params object[] args)
Returns
System.String: Formatted string.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | format | Format string. |
System.Object[] | args | Format arguments. |
IsNullOrEmpty(string?)
Indicates whether the specified string is null or an empty string ("").
public static bool IsNullOrEmpty(this string? value)
Returns
System.Boolean: true if the value parameter is null or an empty string (""); otherwise, false.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | value | The string to test. |
IsNullOrWhitespace(string?)
Indicates whether a specified string is null, empty, or consists only of white-space characters.
public static bool IsNullOrWhitespace(this string? value)
Returns
System.Boolean: true if the value parameter is null or an empty string (""), or if value consists exclusively of white-space characters.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | value | The string to test. |
IsValidCharacterName(string, bool)
Validate if character name is valid using game check.
public static bool IsValidCharacterName(this string value, bool includeLegacy = true)
Returns
System.Boolean: indicator if character is name is valid.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | value | character name to validate. |
System.Boolean | includeLegacy | include legacy names (combined can be 30 instead of 20). |
FirstCharToUpper(string?, CultureInfo?)
Converts the first character of the string to uppercase while leaving the rest of the string unchanged.
public static string? FirstCharToUpper(this string? input, CultureInfo? culture = null)
Returns
System.String: A new string with the first character converted to uppercase.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The input string. |
System.Globalization.CultureInfo | culture |
FirstCharToLower(string?, CultureInfo?)
Converts the first character of the string to lowercase while leaving the rest of the string unchanged.
public static string? FirstCharToLower(this string? input, CultureInfo? culture = null)
Returns
System.String: A new string with the first character converted to lowercase.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The input string. |
System.Globalization.CultureInfo | culture |
StripSoftHyphen(string)
Removes soft hyphen characters (U+00AD) from the input string.
public static string StripSoftHyphen(this string input)
Returns
System.String: A string with all soft hyphens removed.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The input string to remove soft hyphen characters from. |
Truncate(string, int, string)
Truncates the given string to the specified maximum number of characters, appending an ellipsis if truncation occurs.
public static string? Truncate(this string input, int maxChars, string ellipses = "...")
Returns
System.String: The truncated string, or the original string if no truncation is needed.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The string to truncate. |
System.Int32 | maxChars | The maximum allowed length of the string. |
System.String | ellipses | The string to append if truncation occurs (defaults to "..."). |
ToUpper(string, bool, bool, bool, ClientLanguage)
Converts the input string to uppercase based on specified options like capitalizing the first character, normalizing vowels, and excluding certain words based on the selected language.
public static string ToUpper(this string input, bool firstCharOnly, bool everyWord, bool normalizeVowels, ClientLanguage language)
Returns
System.String: A new string with the appropriate characters converted to uppercase.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The input string to be converted to uppercase. |
System.Boolean | firstCharOnly | Whether to capitalize only the first character of the string. |
System.Boolean | everyWord | Whether to capitalize the first letter of each word. |
System.Boolean | normalizeVowels | Whether to normalize vowels to uppercase if they appear at the beginning of a word. |
| Dalamud.Game.ClientLanguage | language | The language context used to determine which words to exclude from capitalization. |
ToUpper(string, bool, bool, bool, ReadOnlySpan<string>)
Converts the input string to uppercase based on specified options like capitalizing the first character, normalizing vowels, and excluding certain words based on the selected language.
public static string ToUpper(this string input, bool firstCharOnly, bool everyWord, bool normalizeVowels, ReadOnlySpan<string> excludedWords)
Returns
System.String: A new string with the appropriate characters converted to uppercase.
Parameters
| Type | Name | Description |
|---|---|---|
System.String | input | The input string to be converted to uppercase. |
System.Boolean | firstCharOnly | Whether to capitalize only the first character of the string. |
System.Boolean | everyWord | Whether to capitalize the first letter of each word. |
System.Boolean | normalizeVowels | Whether to normalize vowels to uppercase if they appear at the beginning of a word. |
System.ReadOnlySpan<System.String> | excludedWords | A list of words to exclude from being capitalized. Words in this list will remain lowercase. |