StrContains
Description
Check whether a Str contains a key.
Three call shapes via OVERLOAD + _Generic on key: StrContains(s, key) – key is Str * or Zstr. StrContains(s, key, key_len) – key is a fixed-length view (Zstr, size). An empty key trivially matches.
Parameters
| Name | Direction | Description |
|---|---|---|
s |
in | Str object to search in. |
key |
in | Substring to search for (Str * / Zstr). |
key_len |
in | Length of key when using the 3-arg fixed-length form. |
Success
Returns true when a match exists. The string is not modified.
Failure
Returns false. The string is not modified.
Usage example (Cross-references)
Usage examples (Cross-references)
- In
Str.Ops.c:100:
// Test string contains/index functions
bool test_str_contains_index(void) {
WriteFmt("Testing StrContains and StrIndexOf variants\n");
DefaultAllocator alloc = DefaultAllocatorInit();- In
Str.Ops.c:107:
Str needle = StrInitFromZstr("World", &alloc);
bool result = StrContains(&haystack, &needle);
result = result && StrContains(&haystack, "Hello");
result = result && StrContains(&haystack, "lo Wo", 5);- In
Str.Ops.c:108:
bool result = StrContains(&haystack, &needle);
result = result && StrContains(&haystack, "Hello");
result = result && StrContains(&haystack, "lo Wo", 5);
result = result && (StrIndexOf(&haystack, &needle) == 6);- In
Str.Ops.c:109:
bool result = StrContains(&haystack, &needle);
result = result && StrContains(&haystack, "Hello");
result = result && StrContains(&haystack, "lo Wo", 5);
result = result && (StrIndexOf(&haystack, &needle) == 6);
result = result && (StrIndexOf(&haystack, "Hello") == 0);- In
Str.Ops.c:113:
result = result && (StrIndexOf(&haystack, "Hello") == 0);
result = result && (StrIndexOf(&haystack, "World", 5) == 6);
result = result && !StrContains(&haystack, "missing");
result = result && (StrIndexOf(&haystack, "missing") == SIZE_MAX);
result = result && StrContains(&haystack, "");- In
Str.Ops.c:115:
result = result && !StrContains(&haystack, "missing");
result = result && (StrIndexOf(&haystack, "missing") == SIZE_MAX);
result = result && StrContains(&haystack, "");
result = result && (StrIndexOf(&haystack, "") == 0);
Last updated on