---
name: "Strings.firstOccurs_1"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Strings.firstOccurs_1"
---

# Strings.firstOccurs\_1(3kaya)

Return the position of the first occurence of a substring

## NAME

Strings::firstOccurs - Return the position of the first occurence of a substring

## SYNOPSIS

**Int firstOccurs(** *String needle, String haystack* **)**

## ARGUMENTS

**needle** The string to check for

**haystack** The string to check

## DESCRIPTION

Returns the position of the first occurence of the *needle* substring in the *haystack* string (or the length of the string if the substring is not in the string).

-

   str = "abcdefgabcde";\
    i = firstOccurs("ab",str); // i = 0\
    i = firstOccurs("de",str); // i = 3\
    i = firstOccurs("efa",str); // i = 12

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Strings.firstOccurs (3kaya)**