flyntwp / flynt

lib/Utils/StringHelpers.php

<?php

namespace Flynt\Utils;

class StringHelpers
{
    /**
     * Converts a string from camel case to kebap case.
     *
     * @since 0.1.0
     *
     * @param string $str The string to convert.
     *
     * @return string
     */
    public static function camelCaseToKebap($str)
    {
        return strtolower(preg_replace('/([a-zA-Z])(?=[A-Z])/', '$1-', $str));
    }

    /**
     * Strips all HTML tags including script and style,
     * and trims text to a certain number of words.
     *
     * @since 0.1.0
     *
     * @param string $str    The string to trim and strip.
     * @param number $length The string length to return.
     *
     * @return string
     */
    public static function trimStrip($str = '', $length = 25)
    {
        return wp_trim_words(wp_strip_all_tags($str), $length, '&hellip;');

It seems like $length can also be of type double; however, parameter $num_words of wp_trim_words() does only seem to accept integer, maybe add an additional type check?

    }

    /**
     * Splits a camel case string.
     *
     * @since 0.1.0
     *
     * @param string $str The string to split.
     *
     * @return string
     */
    public static function splitCamelCase($str)
    {
        $a = preg_split(
            '/(^[^A-Z]+|[A-Z][^A-Z]+)/',
            $str,
            -1, // no limit for replacement count
            PREG_SPLIT_NO_EMPTY // don't return empty elements
            | PREG_SPLIT_DELIM_CAPTURE // don't strip anything from output array
        );
        return implode(' ', $a);
    }

    /**
     * Converts a string from kebap case to camel case.
     *
     * @since 0.1.0
     *
     * @param string $str                        The string to convert.
     * @param boolean $capitalizeFirstCharacter  Sets if the first character should be capitalized.
     *
     * @return string
     */
    public static function kebapCaseToCamelCase($str, $capitalizeFirstCharacter = false)
    {
        $str = str_replace(' ', '', ucwords(str_replace('-', ' ', $str)));
        if (false === $capitalizeFirstCharacter) {
            $str[0] = strtolower($str[0]);
        }
        return $str;
    }

    /**
     * Removes a prefix from a string.
     *
     * @since 0.1.0
     *
     * @param string $prefix The prefix to be removed.
     * @param string $str    The string to manipulate.
     *
     * @return string
     */
    public static function removePrefix($prefix, $str)
    {
        if (substr($str, 0, strlen($prefix)) == $prefix) {
            return substr($str, strlen($prefix));
        }
        return $str;
    }

    /**
     * Checks if a string starts with a certain string.
     *
     * @since 0.1.0
     *
     * @param string $search   The string to search for.
     * @param string $subject  The string to look into.
     *
     * @return boolean Returns true if the subject string starts with the search string.
     */
    public static function startsWith($search, $subject)
    {
        return substr($subject, 0, strlen($search)) === $search;
    }

    /**
     * Checks if a string ends with a certain string.
     *
     * @since 0.1.0
     *
     * @param string $search   The string to search for.
     * @param string $subject  The string to look into.
     *
     * @return boolean Returns true if the subject string ends with the search string.
     */
    public static function endsWith($search, $subject)
    {
        $searchLength = strlen($search);
        $subjectLength = strlen($subject);
        if ($searchLength > $subjectLength) {
            return false;
        }
        return substr_compare($subject, $search, $subjectLength - $searchLength, $searchLength) === 0;
    }
}