HH\Lib\Str\search

Meta Engineer?

This is available as Str\search in the www repository.

Returns the first position of the "needle" string in the "haystack" string, or null if it isn't found

namespace HH\Lib\Str;

function search(
  string $haystack,
  string $needle,
  int $offset = 0,
): ?int;

An optional offset determines where in the haystack the search begins. If the offset is negative, the search will begin that many characters from the end of the string. If the offset is out-of-bounds, a ViolationException will be thrown.

Previously known in PHP as strpos.

Guide

Parameters

  • string $haystack
  • string $needle
  • int $offset = 0

Returns

  • ?int

Examples

$result = Str\search("example_string", "example");
echo($result);
//result: 0

$result = Str\search("example_string", "EXAMPLE");
echo($result);
//result: null

$result = Str\search("example_string", "example", 2); // with offset
echo($result);
//result: null

$result = Str\search("example_string", "uncontained");
echo($result);
//result: null