By John Koster
The finish helper method will make sure that a given $value always ends with exactly one occurrence of the $cap. This helper method is incredibly useful when construction URIs or file paths. The $cap can be any string of characters, and does not have to be only a single character.
The signature for the finish helper method is:
finish($value, $cap)
1use Illuminate\Support\Str;
2
3// /home/path/
4echo Str::finish('/home/path', '/');
5
6// /home/path/
7echo Str::finish('/home/path/', '/');
8
9// Sentences should end with a period, or full stop.
10echo Str::finish('Sentences should end with a period, or full stop', '.');
11
12// Sentences should end with a period, or full stop.
13echo Str::finish('Sentences should end with a period, or full stop.', '.');
Combine this method with slug to create interesting results:
1use Illuminate\Support\Str;
2
3// this_is_a_file_path.html
4echo Str::finish(Str::slug('this is a file path','_'), '.html');
#str_finish($value, $cap)
The str_finish function is a shortcut to calling Str::finish. This function is declared in the global namespace.
∎