String::LastIndexOfAny Method (array<Char>)
Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- anyOf
- Type: array<System::Char>
A Unicode character array containing one or more characters to seek.
Return Value
Type: System::Int32The index position of the last occurrence in this instance where any character in anyOf was found; -1 if no character in anyOf was found.
| Exception | Condition |
|---|---|
| ArgumentNullException | anyOf is nullptr. |
Index numbering starts from zero.
This method begins searching at the last character position of this instance and proceeds backward toward the beginning until either a character in anyOf is found or the first character position has been examined. The search is case-sensitive.
This method performs an ordinal (culture-insensitive) search, where a character is considered equivalent to another character only if their Unicode scalar values are the same. To perform a culture-sensitive search, use the CompareInfo::LastIndexOf method, where a Unicode scalar value representing a precomposed character, such as the ligature "Æ" (U+00C6), might be considered equivalent to any occurrence of the character's components in the correct sequence, such as "AE" (U+0041, U+0045), depending on the culture.
The following example finds the index of the last occurrence of any character in the string "is" within another string.
// Sample for String::LastIndexOfAny(Char[]) using namespace System; int main() { String^ br1 = "0----+----1----+----2----+----3----+----4----+----5----+----6----+-"; String^ br2 = "0123456789012345678901234567890123456789012345678901234567890123456"; String^ str = "Now is the time for all good men to come to the aid of their party."; int start; int at; String^ target = "is"; array<Char>^anyOf = target->ToCharArray(); start = str->Length - 1; Console::WriteLine( "The last character occurrence from position {0} to 0.", start ); Console::WriteLine( "{1}{0}{2}{0}{3}{0}", Environment::NewLine, br1, br2, str ); Console::Write( "A character in '{0}' occurs at position: ", target ); at = str->LastIndexOfAny( anyOf ); if ( at > -1 ) Console::Write( at ); else Console::Write( "(not found)" ); Console::Write( "{0}{0}{0}", Environment::NewLine ); } /* This example produces the following results: The last character occurrence from position 66 to 0. 0----+----1----+----2----+----3----+----4----+----5----+----6----+- 0123456789012345678901234567890123456789012345678901234567890123456 Now is the time for all good men to come to the aid of their party. A character in 'is' occurs at position: 58 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.