README

GrizzIT Translator

此软件包包含简化字符串和数组之间翻译的实现。

要安装此软件包，请运行以下命令

composer require grizz-it/translator

软件包包含两种翻译实现。

Translator 是一个简单的字符串到字符串翻译器。它接受一个左参数将其翻译为右参数，反之亦然。这些翻译可以通过调用正确的方法（getLeft 或 getRight）来实现。调用 getLeft 时，它将从左参数翻译到右。

可以使用 register 方法注册翻译。

可以向构造函数提供默认值。如果这些值为 null，则在检测到无法翻译的字符串时将抛出异常。

ArrayTranslator 的工作方式类似于字符串翻译器。然而，数组翻译器可以从多个结果中进行翻译。

当调用 getLeft 或 getRight 时，数组翻译器仍然将检索一个值（第一个匹配项）。然而，当调用 getAllLeft 或 getAllRight 时，将返回相反一方的所有结果。

注册是另一个主要区别，每项左右翻译都需要注册为数组。即使其中一项只有一个选项。

MatchingTranslator 和 MatchingArrayTranslator 与上述翻译器类似。然而，这些翻译器较慢，因为它们在比较时检查每个单独的键，支持 Unix 文件名模式。

请参阅 CHANGELOG 以获取有关最近更改的更多信息。

请参阅 CONTRIBUTING 和 CODE_OF_CONDUCT 以获取详细信息。

在此，任何人未经限制地获取此软件及其相关文档文件（“软件”）副本（“软件”），免费处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向软件提供者提供软件的人以本条款为条件这样做。