文字列の操作

use Illuminate\Support\Str;

// Str:: のメソッド
$upper = Str::upper('laravel');

// つなげて書く（Fluent Strings）
$title = Str::of('  laravel framework  ')
    ->trim()
    ->title();

// 'Laravel Framework'

// __：翻訳（言語ファイルは「多言語対応」のページを参照）
echo __('Welcome to our application');

echo __('messages.welcome');
// キーが無ければ、'messages.welcome' がそのまま返る

echo trans('messages.welcome');

echo trans_choice('messages.notifications', $unreadCount);

// class_basename
$class = class_basename('Foo\Bar\Baz');
// Baz

// e
echo e('<html>foo</html>');
// &lt;html&gt;foo&lt;/html&gt;

// preg_replace_array
$string = 'The event will take place between :start and :end';

$replaced = preg_replace_array('/:[a-z_]+/', ['8:30', '9:00'], $string);
// The event will take place between 8:30 and 9:00

// str
$string = str('Taylor')->append(' Otwell');
// 'Taylor Otwell'

$snake = str()->snake('FooBar');
// 'foo_bar'

use Illuminate\Support\Str;

Str::after('This is my name', 'This is');
// ' my name'

Str::afterLast('App\Http\Controllers\Controller', '\\');
// 'Controller'

Str::before('This is my name', 'my name');
// 'This is '

Str::beforeLast('This is my name', 'is');
// 'This '

Str::between('This is my name', 'This', 'name');
// ' is my '

Str::betweenFirst('[a] bc [d]', '[', ']');
// 'a'

Str::charAt('This is my name.', 6);
// 's'

Str::substr('The Laravel Framework', 4, 7);
// Laravel

Str::take('Build something amazing!', 5);
// Build

Str::position('Hello, World!', 'Hello');
// 0

Str::position('Hello, World!', 'W');
// 7

Str::ucsplit('FooBar');
// [0 => 'Foo', 1 => 'Bar']

Str::limit('The quick brown fox jumps over the lazy dog', 20);
// The quick brown fox...

Str::limit('The quick brown fox jumps over the lazy dog', 20, ' (...)');
// The quick brown fox (...)

Str::limit('The quick brown fox', 12, preserveWords: true);
// The quick...

Str::words('Perfectly balanced, as all things should be.', 3, ' >>>');
// Perfectly balanced, as >>>

$excerpt = Str::excerpt('This is my name', 'my', [
    'radius' => 3
]);
// '...is my na...'

$excerpt = Str::excerpt('This is my name', 'name', [
    'radius' => 3,
    'omission' => '(...) '
]);
// '(...) my name'

Str::match('/bar/', 'foo bar');
// 'bar'

Str::match('/foo (.*)/', 'foo bar');
// 'bar'

Str::matchAll('/bar/', 'bar foo bar');
// collect(['bar', 'bar'])

// グループ（かっこ）があれば、最初のグループの結果が集まる
Str::matchAll('/f(\w*)/', 'bar fun bar fly');
// collect(['un', 'ly'])

Str::contains('This is my name', 'my');
// true

// 配列なら、どれか1つでも含めば true
Str::contains('This is my name', ['my', 'foo']);
// true

// 大文字小文字を区別しない
Str::contains('This is my name', 'MY', ignoreCase: true);
// true

Str::containsAll('This is my name', ['my', 'name']);
// true

Str::containsAll('This is my name', ['MY', 'NAME'], ignoreCase: true);
// true

Str::doesntContain('This is name', 'my');
// true

Str::doesntContain('This is name', ['my', 'framework']);
// true

Str::doesntContain('This is name', 'MY', ignoreCase: true);
// true

Str::startsWith('This is my name', 'This');
// true

Str::startsWith('This is my name', ['This', 'That', 'There']);
// true

Str::doesntStartWith('This is my name', 'That');
// true

Str::doesntStartWith('This is my name', ['What', 'That', 'There']);
// true

Str::endsWith('This is my name', 'name');
// true

Str::endsWith('This is my name', ['name', 'foo']);
// true

Str::endsWith('This is my name', ['this', 'foo']);
// false

Str::doesntEndWith('This is my name', 'dog');
// true

Str::doesntEndWith('This is my name', ['this', 'foo']);
// true

Str::doesntEndWith('This is my name', ['name', 'foo']);
// false

// is：* は「なんでもよい」
Str::is('foo*', 'foobar');
// true

Str::is('baz*', 'foobar');
// false

Str::is('*.jpg', 'photo.JPG', ignoreCase: true);
// true

Str::isMatch('/foo (.*)/', 'foo bar');
// true

Str::isMatch('/foo (.*)/', 'laravel');
// false

Str::isAscii('Taylor');
// true

Str::isAscii('ü');
// false

Str::isJson('[1,2,3]');
// true

Str::isJson('{"first": "John", "last": "Doe"}');
// true

Str::isJson('{first: "John", last: "Doe"}');
// false

Str::isUrl('http://example.com');
// true

Str::isUrl('laravel');
// false

// 正しいとみなすプロトコルを指定する
Str::isUrl('http://example.com', ['http', 'https']);

Str::isUlid('01gd6r360bp37zj17nxb55yv40');
// true

Str::isUlid('laravel');
// false

Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de');
// true

Str::isUuid('laravel');
// false

// バージョン（1、3、4、5、6、7、8）も確かめられる
Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de', version: 4);
// true

Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de', version: 1);
// false

Str::length('Laravel');
// 7

Str::wordCount('Hello, world!');
// 2

Str::substrCount('If you like ice cream, you will like snow cones.', 'like');
// 2

Str::camel('foo_bar');
// fooBar

Str::kebab('fooBar');
// foo-bar

Str::snake('fooBar');
// foo_bar

// 2番目の引数で、つなぐ文字を変えられる
Str::snake('fooBar', '-');
// foo-bar

Str::studly('foo_bar');
// FooBar

Str::title('a nice title uses the correct case');
// A Nice Title Uses The Correct Case

Str::headline('steve_jobs');
// Steve Jobs

Str::headline('EmailNotificationSent');
// Email Notification Sent

Str::apa('Creating A Project');
// 'Creating a Project'

Str::lower('LARAVEL');
// laravel

Str::upper('laravel');
// LARAVEL

Str::lcfirst('Foo Bar');
// foo Bar

Str::ucfirst('foo bar');
// Foo bar

Str::ucwords('laravel framework');
// Laravel Framework

Str::initials('taylor otwell');
// to

Str::initials('taylor otwell', capitalize: true);
// TO

Str::slug('Laravel 5 Framework', '-');
// laravel-5-framework

Str::reverse('Hello World');
// dlroW olleH

Str::ascii('û');
// 'u'

Str::transliterate('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ');
// 'test@laravel.com'

Str::toBase64('Laravel');
// TGFyYXZlbA==

Str::fromBase64('TGFyYXZlbA==');
// Laravel

$html = Str::markdown('# Laravel');
// <h1>Laravel</h1>

$html = Str::markdown('# Taylor <b>Otwell</b>', [
    'html_input' => 'strip',
]);
// <h1>Taylor Otwell</h1>

// 段落などで包まない、インラインの HTML にする
$html = Str::inlineMarkdown('**Laravel**');
// <strong>Laravel</strong>

Str::markdown('Inject: <script>alert("Hello XSS!");</script>', [
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);
// <p>Inject: alert(&quot;Hello XSS!&quot;);</p>

Str::inlineMarkdown('Inject: <script>alert("Hello XSS!");</script>', [
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);
// Inject: alert(&quot;Hello XSS!&quot;);

$string = 'Laravel 11.x';

Str::replace('11.x', '12.x', $string);
// Laravel 12.x

// はじめは大文字小文字を区別する。区別しないなら caseSensitive: false
Str::replace(
    'php',
    'Laravel',
    'PHP Framework for Web Artisans',
    caseSensitive: false
);
// Laravel Framework for Web Artisans

// ? を、配列の値で順に置きかえる
Str::replaceArray('?', ['8:30', '9:00'], 'The event will take place between ? and ?');
// The event will take place between 8:30 and 9:00

Str::replaceFirst('the', 'a', 'the quick brown fox jumps over the lazy dog');
// a quick brown fox jumps over the lazy dog

Str::replaceLast('the', 'a', 'the quick brown fox jumps over the lazy dog');
// the quick brown fox jumps over a lazy dog

Str::replaceStart('Hello', 'Laravel', 'Hello World');
// Laravel World

Str::replaceStart('World', 'Laravel', 'Hello World');
// Hello World

Str::replaceEnd('World', 'Laravel', 'Hello World');
// Hello Laravel

Str::replaceEnd('Hello', 'Laravel', 'Hello World');
// Hello World

Str::replaceMatches(
    pattern: '/[^A-Za-z0-9]++/',
    replace: '',
    subject: '(+1) 501-555-1000'
);
// '15015551000'

Str::replaceMatches('/\d/', function (array $matches) {
    return '['.$matches[0].']';
}, '123');
// '[1][2][3]'

$string = 'Peter Piper picked a peck of pickled peppers.';

Str::remove('e', $string);
// Ptr Pipr pickd a pck of pickld ppprs.

Str::swap([
    'Tacos' => 'Burritos',
    'great' => 'fantastic',
], 'Tacos are great!');
// Burritos are fantastic!

// 2番目の引数 2 から後ろを置きかえる
Str::substrReplace('1300', ':', 2);
// 13:

// 長さ 0 なら、置きかえずに差しこむ
Str::substrReplace('1300', ':', 2, 0);
// 13:00

Str::chopStart('https://laravel.com', 'https://');
// 'laravel.com'

Str::chopStart('http://laravel.com', ['https://', 'http://']);
// 'laravel.com'

Str::chopEnd('app/Models/Photograph.php', '.php');
// 'app/Models/Photograph'

Str::chopEnd('laravel.com/index.php', ['/index.html', '/index.php']);
// 'laravel.com'

Str::start('this/string', '/');
// /this/string

Str::start('/this/string', '/');
// /this/string

Str::finish('this/string', '/');
// this/string/

Str::finish('this/string/', '/');
// this/string/

Str::wrap('Laravel', '"');
// "Laravel"

Str::wrap('is', before: 'This ', after: ' Laravel!');
// This is Laravel!

Str::unwrap('-Laravel-', '-');
// Laravel

Str::unwrap('{framework: "Laravel"}', '{', '}');
// framework: "Laravel"

Str::trim(' foo bar ');
// 'foo bar'

Str::ltrim('  foo bar  ');
// 'foo bar  '

Str::rtrim('  foo bar  ');
// '  foo bar'

Str::squish('    laravel    framework    ');
// laravel framework

Str::deduplicate('The   Laravel   Framework');
// The Laravel Framework

// 整える文字を変える
Str::deduplicate('The---Laravel---Framework', '-');
// The-Laravel-Framework

Str::padBoth('James', 10, '_');
// '__James___'

Str::padBoth('James', 10);
// '  James   '

Str::padLeft('James', 10, '-=');
// '-=-=-James'

Str::padLeft('James', 10);
// '     James'

Str::padRight('James', 10, '-');
// 'James-----'

Str::padRight('James', 10);
// 'James     '

Str::repeat('a', 5);
// aaaaa

Str::mask('taylor@example.com', '*', 3);
// tay***************

Str::mask('taylor@example.com', '*', -15, 3);
// tay***@example.com

$text = "The quick brown fox jumped over the lazy dog.";

Str::wordWrap($text, characters: 20, break: "<br />\n");

/*
The quick brown fox<br />
jumped over the lazy<br />
dog.
*/

Str::plural('car');
// cars

Str::plural('child');
// children

// 数を渡すと、数に合う形になる
Str::plural('child', 2);
// children

Str::plural('child', 1);
// child

// prependCount で、数を前に付ける
Str::plural('car', 1000, prependCount: true);
// 1,000 cars

Str::pluralStudly('VerifiedHuman');
// VerifiedHumans

Str::pluralStudly('UserFeedback');
// UserFeedback

Str::pluralStudly('VerifiedHuman', 2);
// VerifiedHumans

Str::pluralStudly('VerifiedHuman', 1);
// VerifiedHuman

Str::singular('cars');
// car

Str::singular('children');
// child

Str::counted('order', 1);
// 1 order

Str::counted('order', 1000);
// 1,000 orders

$random = Str::random(40);

$password = Str::password();
// 'EbJo2vE-AS:U,$%_gkrV4n,q~1xy/-_4'  （はじめは32文字）

$password = Str::password(12);
// 'qwuar>#V|i]N'

return (string) Str::uuid();

return (string) Str::uuid7();

// uuid7 には、日時（DateTimeInterface）も渡せる
return (string) Str::uuid7(time: now());

return (string) Str::orderedUuid();

return (string) Str::ulid();
// 01gd6r360bp37zj17nxb55yv40

use Illuminate\Support\Carbon;
use Illuminate\Support\Str;

$date = Carbon::createFromId((string) Str::ulid());

// Str::random
Str::createRandomStringsUsing(function () {
    return 'fake-random-string';
});

Str::createRandomStringsNormally();

// Str::ulid
use Symfony\Component\Uid\Ulid;

Str::createUlidsUsing(function () {
    return new Ulid('01HRDBNHHCKNW2AK4Z29SN82T9');
});

Str::createUlidsNormally();

// Str::uuid
use Ramsey\Uuid\Uuid;

Str::createUuidsUsing(function () {
    return Uuid::fromString('eadbfeac-5258-45c2-bab7-ccb9b5ef74f9');
});

Str::createUuidsNormally();

use Illuminate\Support\Str;

$string = Str::of('  laravel framework  ')
    ->trim()
    ->title()
    ->append('!');

// 'Laravel Framework!'

Str::of('This is my name')->after('This is');
// ' my name'

Str::of('App\Http\Controllers\Controller')->afterLast('\\');
// 'Controller'

Str::of('a nice title uses the correct case')->apa();
// A Nice Title Uses the Correct Case

Str::of('ü')->ascii();
// 'u'

Str::of('This is my name')->before('my name');
// 'This is '

Str::of('This is my name')->beforeLast('is');
// 'This '

Str::of('This is my name')->between('This', 'name');
// ' is my '

Str::of('[a] bc [d]')->betweenFirst('[', ']');
// 'a'

Str::of('foo_bar')->camel();
// 'fooBar'

Str::of('This is my name.')->charAt(6);
// 's'

Str::of('Foo\Bar\Baz')->classBasename();
// 'Baz'

Str::of('https://laravel.com')->chopStart('https://');
// 'laravel.com'

Str::of('http://laravel.com')->chopStart(['https://', 'http://']);
// 'laravel.com'

Str::of('https://laravel.com')->chopEnd('.com');
// 'https://laravel'

Str::of('http://laravel.com')->chopEnd(['.com', '.io']);
// 'http://laravel'

Str::of('This is my name')->contains('my');
// true

Str::of('This is my name')->contains(['my', 'foo']);
// true

Str::of('This is my name')->contains('MY', ignoreCase: true);
// true

Str::of('This is my name')->containsAll(['my', 'name']);
// true

Str::of('This is my name')->containsAll(['MY', 'NAME'], ignoreCase: true);
// true

Str::of('order')->counted(1);
// 1 order

Str::of('order')->counted(1000);
// 1,000 orders

Str::of('The   Laravel   Framework')->deduplicate();
// The Laravel Framework

// つなげて書く形では、整える文字は最初の引数
Str::of('The---Laravel---Framework')->deduplicate('-');
// The-Laravel-Framework

Str::of('This is name')->doesntContain('my');
// true

Str::of('This is name')->doesntContain(['my', 'framework']);
// true

Str::of('This is my name')->doesntContain('MY', ignoreCase: true);
// false

Str::of('This is my name')->doesntEndWith('dog');
// true

Str::of('This is my name')->doesntEndWith(['this', 'foo']);
// true

Str::of('This is my name')->doesntEndWith(['name', 'foo']);
// false

Str::of('This is my name')->doesntStartWith('That');
// true

Str::of('This is my name')->doesntStartWith(['What', 'That', 'There']);
// true

Str::of('This is my name')->endsWith('name');
// true

Str::of('This is my name')->endsWith(['name', 'foo']);
// true

Str::of('This is my name')->endsWith(['this', 'foo']);
// false

Str::of('this/string')->finish('/');
// this/string/

Str::of('this/string/')->finish('/');
// this/string/

Str::of('TGFyYXZlbA==')->fromBase64();
// Laravel

Str::of('taylor_otwell')->headline();
// Taylor Otwell

Str::of('EmailNotificationSent')->headline();
// Email Notification Sent

Str::of('foobar')->is('foo*');
// true

Str::of('foobar')->is('baz*');
// false

Str::of('Taylor')->isAscii();
// true

Str::of('ü')->isAscii();
// false

Str::of('[1,2,3]')->isJson();
// true

Str::of('{first: "John", last: "Doe"}')->isJson();
// false

Str::of('01gd6r360bp37zj17nxb55yv40')->isUlid();
// true

Str::of('Taylor')->isUlid();
// false

Str::of('http://example.com')->isUrl();
// true

Str::of('Taylor')->isUrl();
// false

// 正しいとみなすプロトコルを指定する
Str::of('http://example.com')->isUrl(['http', 'https']);

Str::of('5ace9ab9-e9cf-4ec6-a19d-5881212a452c')->isUuid();
// true

Str::of('Taylor')->isUuid();
// false

// バージョンも確かめられる
Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->isUuid(version: 4);
// true

Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->isUuid(version: 1);
// false

Str::of('fooBar')->kebab();
// foo-bar

Str::of('Foo Bar')->lcfirst();
// foo Bar

Str::of('Laravel')->length();
// 7

Str::of('The quick brown fox jumps over the lazy dog')->limit(20);
// The quick brown fox...

Str::of('The quick brown fox jumps over the lazy dog')->limit(20, ' (...)');
// The quick brown fox (...)

Str::of('The quick brown fox')->limit(12, preserveWords: true);
// The quick...

Str::of('LARAVEL')->lower();
// 'laravel'

Str::of('# Laravel')->markdown();
// <h1>Laravel</h1>

Str::of('# Taylor <b>Otwell</b>')->markdown([
    'html_input' => 'strip',
]);
// <h1>Taylor Otwell</h1>

Str::of('**Laravel**')->inlineMarkdown();
// <strong>Laravel</strong>

Str::of('taylor@example.com')->mask('*', 3);
// tay***************

Str::of('taylor@example.com')->mask('*', -15, 3);
// tay***@example.com

// 2番目と3番目の引数の、どちらもマイナスにできる
Str::of('taylor@example.com')->mask('*', 4, -4);
// tayl**********.com

Str::of('foo bar')->match('/bar/');
// 'bar'

Str::of('foo bar')->match('/foo (.*)/');
// 'bar'

Str::of('bar foo bar')->matchAll('/bar/');
// collect(['bar', 'bar'])

Str::of('bar fun bar fly')->matchAll('/f(\w*)/');
// collect(['un', 'ly'])

Str::of('foo bar')->isMatch('/foo (.*)/');
// true

Str::of('laravel')->isMatch('/foo (.*)/');
// false

Str::of('James')->padBoth(10, '_');
// '__James___'

Str::of('James')->padLeft(10, '-=');
// '-=-=-James'

Str::of('James')->padRight(10, '-');
// 'James-----'

Str::of('car')->plural();
// cars

Str::of('child')->plural(2);
// children

Str::of('child')->plural(1);
// child

Str::of('car')->plural(1000, prependCount: true);
// 1,000 cars

Str::of('Hello, World!')->position('W');
// 7

Str::of('Arkansas is quite beautiful!')->remove('quite ');
// Arkansas is beautiful!

Str::of('a')->repeat(5);
// aaaaa

Str::of('Laravel 6.x')->replace('6.x', '7.x');
// Laravel 7.x

Str::of('macOS 13.x')->replace(
    'macOS', 'iOS', caseSensitive: false
);

$string = 'The event will take place between ? and ?';

Str::of($string)->replaceArray('?', ['8:30', '9:00']);
// The event will take place between 8:30 and 9:00

Str::of('the quick brown fox jumps over the lazy dog')->replaceFirst('the', 'a');
// a quick brown fox jumps over the lazy dog

Str::of('the quick brown fox jumps over the lazy dog')->replaceLast('the', 'a');
// the quick brown fox jumps over a lazy dog

Str::of('(+1) 501-555-1000')->replaceMatches('/[^A-Za-z0-9]++/', '');
// '15015551000'

Str::of('123')->replaceMatches('/\d/', function (array $matches) {
    return '['.$matches[0].']';
});
// '[1][2][3]'

Str::of('Hello World')->replaceStart('Hello', 'Laravel');
// Laravel World

Str::of('Hello World')->replaceEnd('World', 'Laravel');
// Hello Laravel

Str::of('cars')->singular();
// car

Str::of('Laravel Framework')->slug('-');
// laravel-framework

Str::of('fooBar')->snake();
// foo_bar

Str::of('    laravel    framework    ')->squish();
// laravel framework

Str::of('this/string')->start('/');
// /this/string

Str::of('This is my name')->startsWith('This');
// true

Str::of('This is my name')->startsWith(['This', 'That']);
// true

Str::of('foo_bar')->studly();
// FooBar

Str::of('Laravel Framework')->substr(8);
// Framework

Str::of('Laravel Framework')->substr(8, 5);
// Frame

Str::of('1300')->substrReplace(':', 2);
// 13:

Str::of('The Framework')->substrReplace(' Laravel', 3, 0);
// The Laravel Framework

Str::of('Tacos are great!')
    ->swap([
        'Tacos' => 'Burritos',
        'great' => 'fantastic',
    ]);
// Burritos are fantastic!

Str::of('Build something amazing!')->take(5);
// Build

Str::of('a nice title uses the correct case')->title();
// A Nice Title Uses The Correct Case

Str::of('Laravel')->toBase64();
// TGFyYXZlbA==

Str::of('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ')->transliterate();
// 'test@laravel.com'

Str::of('  Laravel  ')->trim();
// 'Laravel'

Str::of('/Laravel/')->trim('/');
// 'Laravel'

Str::of('  Laravel  ')->ltrim();
// 'Laravel  '

Str::of('/Laravel/')->ltrim('/');
// 'Laravel/'

Str::of('  Laravel  ')->rtrim();
// '  Laravel'

Str::of('/Laravel/')->rtrim('/');
// '/Laravel'

Str::of('foo bar')->ucfirst();
// Foo bar

Str::of('laravel framework')->ucwords();
// Laravel Framework

Str::of('-Laravel-')->unwrap('-');
// Laravel

Str::of('{framework: "Laravel"}')->unwrap('{', '}');
// framework: "Laravel"

Str::of('laravel')->upper();
// LARAVEL

Str::of('Hello, world!')->wordCount();
// 2

Str::of('Perfectly balanced, as all things should be.')->words(3, ' >>>');
// Perfectly balanced, as >>>

Str::of('Laravel')->wrap('"');
// "Laravel"

Str::of('is')->wrap(before: 'This ', after: ' Laravel!');
// This is Laravel!

$excerpt = Str::of('This is my name')->excerpt('my', [
    'radius' => 3
]);
// '...is my na...'

$excerpt = Str::of('This is my name')->excerpt('name', [
    'radius' => 3,
    'omission' => '(...) '
]);
// '(...) my name'

Str::of('Inject: <script>alert("Hello XSS!");</script>')->markdown([
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);
// <p>Inject: alert(&quot;Hello XSS!&quot;);</p>

Str::of('Inject: <script>alert("Hello XSS!");</script>')->inlineMarkdown([
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);
// Inject: alert(&quot;Hello XSS!&quot;);

// append：後ろに足す
Str::of('Taylor')->append(' Otwell');
// 'Taylor Otwell'

// prepend：前に足す
Str::of('Framework')->prepend('Laravel ');
// Laravel Framework

// newLine：改行を足す
Str::of('Laravel')->newLine()->append('Framework');
// 'Laravel
//  Framework'

// basename：パスの最後の部分
Str::of('/foo/bar/baz')->basename();
// 'baz'

// 取りのぞく拡張子も指定できる
Str::of('/foo/bar/baz.jpg')->basename('.jpg');
// 'baz'

// dirname：親のディレクトリ
Str::of('/foo/bar/baz')->dirname();
// '/foo/bar'

// さかのぼる階層の数も指定できる
Str::of('/foo/bar/baz')->dirname(2);
// '/foo'

// exactly：完全に同じか
Str::of('Laravel')->exactly('Laravel');
// true

// explode：区切りの文字で分けて、コレクションにする
Str::of('foo bar baz')->explode(' ');
// collect(['foo', 'bar', 'baz'])

// split：正規表現で分けて、コレクションにする
Str::of('one, two, three')->split('/[\s,]+/');
// collect(["one", "two", "three"])

// scan：sscanf の書式で読みとって、コレクションにする
Str::of('filename.jpg')->scan('%[^.].%s');
// collect(['filename', 'jpg'])

// ucsplit：大文字のところで区切って、コレクションにする
Str::of('Foo Bar')->ucsplit();
// collect(['Foo ', 'Bar'])

// initials：頭文字
Str::of('Taylor Otwell')->initials()->upper();
// TO

// hash：指定のアルゴリズムでハッシュにする
Str::of('secret')->hash(algorithm: 'sha256');
// '2bb80d537b1da3e38bd30361aa855686bde0eacd7162fef6a25fe97bf527a25b'

// isEmpty と isNotEmpty
Str::of('  ')->trim()->isEmpty();
// true

Str::of('Laravel')->trim()->isEmpty();
// false

Str::of('  ')->trim()->isNotEmpty();
// false

Str::of('Laravel')->trim()->isNotEmpty();
// true

// test：正規表現に合うか（isMatch と同じ）
Str::of('Laravel Framework')->test('/Laravel/');
// true

// stripTags：HTML と PHP のタグを取りのぞく
Str::of('<a href="https://laravel.com">Taylor <b>Otwell</b></a>')->stripTags();
// Taylor Otwell

// 残したいタグも指定できる
Str::of('<a href="https://laravel.com">Taylor <b>Otwell</b></a>')->stripTags('<b>');
// Taylor <b>Otwell</b>

$encrypted = Str::of('secret')->encrypt();

$decrypted = $encrypted->decrypt();
// 'secret'

$htmlString = Str::of('Nuno Maduro')->toHtmlString();

$uri = Str::of('https://example.com')->toUri();

use Illuminate\Support\Stringable;

$hash = Str::of('Laravel')->pipe('md5')->prepend('Checksum: ');
// 'Checksum: a5c95b86291ea299fcbe64458ed12702'

$closure = Str::of('foo')->pipe(function (Stringable $str) {
    return 'bar';
});
// 'bar'

$string = Str::of('Laravel')
    ->append(' Framework')
    ->tap(function (Stringable $string) {
        dump('String after append: '.$string);
    })
    ->upper();
// LARAVEL FRAMEWORK

use Illuminate\Support\Stringable;

$string = Str::of('Taylor')
    ->when(true, function (Stringable $string) {
        return $string->append(' Otwell');
    });
// 'Taylor Otwell'

$string = Str::of('tony stark')
    ->whenContains('tony', function (Stringable $string) {
        return $string->title();
    });
// 'Tony Stark'

// 配列なら、どれか1つでも含めば実行される
$string = Str::of('tony stark')
    ->whenContains(['tony', 'hulk'], function (Stringable $string) {
        return $string->title();
    });
// Tony Stark

$string = Str::of('tony stark')
    ->whenContainsAll(['tony', 'stark'], function (Stringable $string) {
        return $string->title();
    });
// 'Tony Stark'

$string = Str::of('disney world')->whenDoesntEndWith('land', function (Stringable $string) {
    return $string->title();
});
// 'Disney World'

$string = Str::of('disney world')->whenDoesntStartWith('sea', function (Stringable $string) {
    return $string->title();
});
// 'Disney World'

$string = Str::of('disney world')->whenStartsWith('disney', function (Stringable $string) {
    return $string->title();
});
// 'Disney World'

$string = Str::of('disney world')->whenEndsWith('world', function (Stringable $string) {
    return $string->title();
});
// 'Disney World'

$string = Str::of('laravel')->whenExactly('laravel', function (Stringable $string) {
    return $string->title();
});
// 'Laravel'

$string = Str::of('framework')->whenNotExactly('laravel', function (Stringable $string) {
    return $string->title();
});
// 'Framework'

$string = Str::of('foo/bar')->whenIs('foo/*', function (Stringable $string) {
    return $string->append('/baz');
});
// 'foo/bar/baz'

$string = Str::of('laravel')->whenIsAscii(function (Stringable $string) {
    return $string->title();
});
// 'Laravel'

$string = Str::of('01gd6r360bp37zj17nxb55yv40')->whenIsUlid(function (Stringable $string) {
    return $string->substr(0, 8);
});
// '01gd6r36'

$string = Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->whenIsUuid(function (Stringable $string) {
    return $string->substr(0, 8);
});
// 'a0a2a2d2'

$string = Str::of('laravel framework')->whenTest('/laravel/', function (Stringable $string) {
    return $string->title();
});
// 'Laravel Framework'

$string = Str::of('  ')->trim()->whenEmpty(function (Stringable $string) {
    return $string->prepend('Laravel');
});
// 'Laravel'

$string = Str::of('Framework')->whenNotEmpty(function (Stringable $string) {
    return $string->prepend('Laravel ');
});
// 'Laravel Framework'