README

Cardinal

一个用于处理方位的小型包装对象。

安装

composer require joskolenberg/cardinal

示例

使用度数（0到359.999）创建对象，并将其格式化为字符串。

Cardinal::make(45)->format() // => 'NE'

使用精度参数来提高或降低精确度。

Cardinal::make(66)->format(1) // => 'E'
Cardinal::make(66)->format(2) // => 'NE'
Cardinal::make(66)->format(3) // => 'ENE'

使用第二个和第三个参数切换到带有分隔符的完整方向。

Cardinal::make(250)->format(3, true, '-') // => 'WEST-SOUTH-WEST'

从字符串（带或不带任何分隔符）创建对象并返回度数。

Cardinal::make('NNW')->degrees // => 337.5
Cardinal::make('South-West')->degrees // => 225
Cardinal::make('West NorthWest')->degrees // => 292.5

使用formatLocalized()获取本地化字符串。

Cardinal::make(250)->formatLocalized(3, true, '-') // => 'West-South-West'

重写lang()来创建您自己的本地化。

use JosKolenberg\Cardinal\Cardinal;

class DutchCardinal extends Cardinal
{
    protected function lang(): array
    {
        return [
            'N' => 'N',
            'E' => 'O',
            'S' => 'Z',
            'W' => 'W',
            'NORTH' => 'Noord',
            'EAST' => 'Oost',
            'SOUTH' => 'Zuid',
            'WEST' => 'West',
        ];
    }
}

Cardinal::make(157.5)->formatLocalized(3, true, '-') // => 'Zuid-Zuid-Oost'

或者将本地化集成到您的框架中。例如Laravel。

use JosKolenberg\Cardinal\Cardinal;

class LocalizedCardinal extends Cardinal
{
    protected function lang(): array
    {
        return [
            'N' => __('app.cardinal.n'),
            'E' => __('app.cardinal.e'),
            'S' => __('app.cardinal.s'),
            'W' => __('app.cardinal.w'),
            'NORTH' => __('app.cardinal.north'),
            'EAST' => __('app.cardinal.east'),
            'SOUTH' => __('app.cardinal.south'),
            'WEST' => __('app.cardinal.west'),
        ];
    }
}

这就完成了！有任何建议或问题吗？请与我联系！

编码愉快！

Jos Kolenberg jos@kolenberg.net