value, $locale?->value ?? $this->value); } /** * Get the language code part of the locale. * * @return non-empty-string The language code. * * @psalm-mutation-free */ public function getLanguage(): string { /** @var non-empty-string */ return NativeLocale::getPrimaryLanguage($this->value); } /** * Get the display name of the language for the locale. * * @param Locale|null $locale The locale for which to get the language name. Defaults to the current locale if not specified. * * @return non-empty-string The display name of the language. * * @psalm-mutation-free */ public function getDisplayLanguage(null|Locale $locale = null): string { /** @var non-empty-string */ return NativeLocale::getDisplayLanguage($this->value, $locale?->value ?? $this->value); } /** * Checks if the locale has a script specified. * * @return bool True if the locale has a script, false otherwise. * * @psalm-mutation-free */ public function hasScript(): bool { return $this->getScript() !== null; } /** * Get the script of the locale. * * @return non-empty-string|null The script of the locale, or null if not applicable. * * @psalm-mutation-free */ public function getScript(): null|string { return NativeLocale::getScript($this->value) ?: null; } /** * Checks if the locale has a region specified. * * @return bool True if the locale has a region, false otherwise. * * @psalm-mutation-free */ public function hasRegion(): bool { return $this->getRegion() !== null; } /** * Get the display name of the region for the locale. * * @param Locale|null $locale The locale for which to get the region name. Defaults to the current locale if not specified. * * @return non-empty-string|null The display name of the region, or null if not applicable. * * @psalm-mutation-free */ public function getDisplayRegion(null|Locale $locale = null): null|string { return NativeLocale::getDisplayRegion($this->value, $locale?->value ?? $this->value) ?: null; } /** * Get the alpha-2 country code part of the locale, if present. * * @return non-empty-string|null The alpha-2 country code, or null if not present. * * @psalm-mutation-free */ public function getRegion(): null|string { return NativeLocale::getRegion($this->value) ?: null; } }