GitHub - alecrabbit/php-wcwidth: Calculate width of unicode strings rendered to a terminal (original) (raw)

🇺🇦 🇼 PHP Wide Character Width

This is kinda port of python's jquast/wcwidth

🌐 Unicode release files

• Installation
• Quick start
• Usage
• FFI Extension

Installation

$ composer require alecrabbit/php-wcwidth

Quick start

use function AlecRabbit\WcWidth\wcwidth; use function AlecRabbit\WcWidth\wcswidth;

echo wcwidth('a'); // 1 echo wcwidth('é'); // 1 echo wcwidth('🐘'); // 2 echo wcswidth('🐘🐘🐘'); // 6

echo wcwidth('🐘🐘🐘'); // 2 - only first char is considered

see doc/usage.md for more details.

FFI extension

Note ‼️ Experimental feature.

For improved performance, consider leveraging the Foreign Function Interface (FFI) extension, if available. To enable this feature, set the USE_FFI environment variable to true.

Note When using ffi extension version value is ignored completely.