This is a tool that's all about space. Specifically blank space and line breaks. The purpose of this tool is to provide an easier way to add spaces in applications by using generated variables, instead of having to continually type them in. So something like this:
$name = $someRandomVariable . " " . "the rest of whatever text here";
$message = "Etiam porta sem malesuada magna mollis euismod.";
$message .= "\n";
$message .= "Maecenas faucibus mollis interdum.";
Can become something like this:
$name = $someRandomVariable . $spaceVariable . "the rest of whatever text here";
$message = "Etiam porta sem malesuada magna mollis euismod.";
$message .= $lineBreakVariable;
$message .= "Maecenas faucibus mollis interdum.";
If any of the following are applicable to your project, then the directory structure should follow industry best practices by being named the following.
src/
/Newline # -> Contains all of the newline classes
- Newline.php # -> newline generator
/Space # -> Contains all of the black space classes
- Space.php # -> blank space generator
composer.json # -> Autoloading for 'apps'
Via Composer
$ composer require Newball/SpaceTools
For blank spaces, use the space class.
$space = new Newball\SpaceTools\Space();
$bs = $space->spaces;
echo 'Hey,' . $bs . 'Space!';
The space class has two parameters. $chars is a number and indicates the amount of spaces wanted, $kind accepts either 'space' or 'escaped'. Space will return a " ", while escaped will return "\040". By default these parameters are set to '1' and 'space'.
$space = new Newball\SpaceTools\Space(5,'escaped');
$bs = $space->spaces;
echo 'Hey,' . $bs . 'Tons' . $bs . 'Of' . $bs . 'Space';
For line breaks / newlines, use the newline class.
$newline = new Newball\SpaceTools\Newline();
$nl = $newline->nl;
echo 'Hey,' . $nl . 'A New Line!';
The newline class has two parameters. $lines is a number and indicates the amount of newlines wanted, $kind accepts either 'linebreak', 'return' or 'both'. linebreak will return a "\n", return will return a "\r", both will return "\r\n". By default these parameters are set to '1' and 'linebreal'.
$newline = new Newball\SpaceTools\Newline(2,'both');
$nl = $newline->nl;
echo 'Hey,' . $nl . 'A Bunch' . $nl . 'Of' . $nl . 'Lines';
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING and CODE_OF_CONDUCT for details.
If you discover any security related issues, please email contact@leonewball.com instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.