phobos ~master (2024-10-03T07:50:27Z)

indexOf

std string

Searches for substring in s.

  1. ptrdiff_t indexOf(Range s, dchar c, CaseSensitive cs)
  2. ptrdiff_t indexOf(const(C)[] s, dchar c, CaseSensitive cs)
  3. ptrdiff_t indexOf(Range s, dchar c, size_t startIdx, CaseSensitive cs)
  4. ptrdiff_t indexOf(const(C)[] s, dchar c, size_t startIdx, CaseSensitive cs)
  5. ptrdiff_t indexOf(Range s, const(Char)[] sub)
  6. ptrdiff_t indexOf(Range s, const(Char)[] sub, CaseSensitive cs)
    ptrdiff_t
    indexOf
    (
    Range
    Char
    )
    (
    Range s
    ,
    const(Char)[] sub
    ,
    in CaseSensitive cs
    )
    if (
    isForwardRange!Range &&
    isSomeChar!(ElementEncodingType!Range)
    &&
    isSomeChar!Char
    )
  7. ptrdiff_t indexOf(const(Char1)[] s, const(Char2)[] sub, size_t startIdx)
  8. ptrdiff_t indexOf(const(Char1)[] s, const(Char2)[] sub, size_t startIdx, CaseSensitive cs)

Parameters

s Range

string or ForwardRange of characters to search in correct UTF format

sub const(Char)[]

substring to search for

cs CaseSensitive

Yes.caseSensitive (default) or No.caseSensitive

Return Value

Type: ptrdiff_t

the index of the first occurrence of sub in s with respect to the start index startIdx. If sub is not found, then -1 is returned. If the arguments are not valid UTF, the result will still be in the range [-1 .. s.length], but will not be reliable otherwise. If sub is found the value of the returned index is at least startIdx.

Throws

If the sequence starting at startIdx does not represent a well formed codepoint, then a std.utf.UTFException may be thrown.

Bugs

Does not work with case insensitive strings where the mapping of tolower and toupper is not 1:1.

Examples

import std.typecons : No;

string s = "Hello World";
assert(indexOf(s, "Wo", 4) == 6);
assert(indexOf(s, "Zo", 100) == -1);
assert(indexOf(s, "wo", 3, No.caseSensitive) == 6);
import std.typecons : No;

string s = "Hello World";
assert(indexOf(s, "Wo") == 6);
assert(indexOf(s, "Zo") == -1);
assert(indexOf(s, "wO", No.caseSensitive) == 6);

Meta

Source

See Implementation

std string aliasesclassesfunctions

Page generated by adrdox