string.api

string {
    string capitalize()
    string titleize()
    string toLower()
    string toUpper()
    
    int length()
    
    string slice(int $offset, int $length = magic)
    string replaceSlice(string $replacement, int $offset, int $length = magic)
    //string deleteSlice(int $offset, int $length = magic)
    
    int indexOf(string $string, int $offset = 0, int $length = magic)
    int lastIndexOf(string $string, int $offset = 0, int $length = magic)
    
    bool startsWith(string $string)
    bool endsWith(string $string)
    bool contains(string $string)
    
    int count(string $string)
    
    string[] split(string $separator, int $limit = 0)
    string[] chunk(int $chunkLength = 1)
    
    string replace(string $from, string $to, int $limit = 0)
    string replace(array(string $from => string $to) $replacements, int $limit = 0)
    
    string padLeft(int $length, char $fillChar = ' ')
    string padRight(int $length, char $fillChar = ' ')
    
    string trim(string $characters = " \t\n\r\v\0")
    string trimLeft(string $characters = " \t\n\r\v\0")
    string trimRight(string $characters = " \t\n\r\v\0")
    
    string repeat(int $times)
    string reverse()
    
    int compare(string $string)
    int naturalCompare(string $string)
    
    StringCaseInsensitiveView caseInsensitive()
    
    //StringSliceView sliceView(int $offset, int $length = magic)
}

StringCaseInsensitiveView {
    int indexOf(string $string, int $offset = 0, int $length = magic)
    int lastIndexOf(string $string, int $offset = 0, int $length = magic)
    bool startsWith(string $string)
    bool endsWith(string $string)
    bool contains(string $string)
    
    int count(string $string)
    string[] split(string $separator, int $limit = 0)
    
    string replace(string $from, string $to, int $limit = 0)
    string replace(array(string $from => string $to) $replacements, int $limit = 0)
    
    int compare(string $string)
    int naturalCompare(string $string)
}