GhostManSec
Server: LiteSpeed
System: Linux premium197.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
User: parhudrw (1725)
PHP: 7.4.33
Disabled: NONE
Upload Files
File: //home/parhudrw/ve.anqa.it/wp-content/plugins/depicter/vendor/averta/core/src/Utility/Str.php
<?php
namespace Averta\Core\Utility;


class Str
{
	/**
	 * Convert string to camelCase
	 *
	 * @param string  $input                     The string to convert
	 * @param string  $separator                 The character that should be removed
	 * @param bool    $capitalizeFirstChar       Whether to capitalize the first character or not
	 *
	 * @return string
	 */
	public static function camelize( $input, $separator = "_", $capitalizeFirstChar = false ) {

		$string = str_replace( $separator, '', ucwords( $input, $separator ) );

		if ( ! $capitalizeFirstChar ) {
			$string = lcfirst( $string );
		}

		return $string;
	}

	/**
	 * Generates and trims a persistent simple hash
	 *
	 * @param string $data   The input string.
	 * @param int    $start  If offset is negative, the returned string will start at the offset'th character from the end of string.
	 * @param int    $length If length is given and is positive, the string returned will contain at most length characters beginning from start.
	 *
	 * @return false|string
	 */
	public static function simpleHash( $data, $start = 0, $length = 10 ){
		return self::hash( $algorithm = 'md5' , $data, $start, $length );
	}

	/**
	 * Generates and trims a hash value
	 *
	 * @param string $algorithm   Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..)
	 * @param string $data        The input string.
	 * @param int    $start       If offset is negative, the returned string will start at the offset'th character from the end of string.
	 * @param int    $length      If length is given and is positive, the string returned will contain at most length characters beginning from start.
	 *
	 * @return false|string
	 */
	public static function hash( $algorithm , $data, $start = 0, $length = 100 ){
		return substr( hash( $algorithm, $data, false ), $start, $length );
	}

	/**
	 * Generates a persistent simple short hash
	 *
	 * @param string $data        The input string.
	 * @param bool   $binary
	 *
	 * @return string
	 */
	public static function shortHash( $data, $binary = false ){
		return hash( 'adler32', $data, $binary );
	}

	/**
	 * Extracts and returns a part of string based on provided regex.
	 *
	 * @param string $string      String to search in by regex
	 * @param string $regex       Regular expression for extracting a part of URL
	 * @param int    $matchIndex  Which part of matched part we are looking for. Set -1 to get all matches.
	 *
	 * @return bool|mixed   Returns the matched part on success, and false on failure.
	 */
	public static function extractByRegex( $string, $regex, $matchIndex = 1 ){

		$matches = [];

		preg_match(
			$regex,
			$string,
			$matches
		);

		if( $matchIndex === -1 ){
			return $matches;
		}

		if( isset( $matches[ $matchIndex ] ) ){
			return $matches[ $matchIndex ];
		}

		return false;
	}

    /**
     * Converts semantic version to decimal
     *
     * @param string $version
     *
     * @return int
     */
    public static function versionToDecimal( $version = '0.0.0' ) {
        $result = '';
        $versionParts = explode( '.', $version );
        foreach( $versionParts as $value ) {
            $result .= substr( "00" . $value, -3 );
        }
        return (int) $result;
    }

    /**
     * Trims a text by character length
     *
     * @param string $text    The text to be trimmed
     * @param int $maxLength  Number of characters in text.
     * @param string $more    What to append if $text needs to be trimmed. Default ' …'
     *
     * @return string
     */
    public static function trimByChars( $text, $maxLength = 1000, $more = " ..." ){
        $textLength = function_exists('mb_strwidth') ? mb_strwidth( $text ) : strlen( $text );

        if( $textLength > $maxLength && ! empty( $maxLength ) && ! empty( $text ) ){
            return function_exists( 'mb_strimwidth' ) ? mb_strimwidth( $text, 0, $maxLength, '' ) . $more : substr( $text, 0, $maxLength ) . $more;
        }
        return $text;
    }

    /**
     * Trims text to a certain number of words.
     *
     * @param string $text     The text to be trimmed
     * @param int $maxLength   Number of words.
     * @param string $more     What to append if $text needs to be trimmed. Default ' …'.
     *
     * @return mixed|string
     */
    public static function trimByWords( $text, $maxLength, $more = " ..." ) {
        $words = preg_split('/\s+/u', $text, $maxLength + 1);
        if( count( $words ) > $maxLength ) {
		    array_pop($words);
		    $text = implode(' ', $words);
		    $text .= $more;
		}
	    return $text;
    }

    /**
     * Removes a string from the end of a text
     *
     * @param string $text          the original text
     * @param string $stringToTrim  the string that should be removed from end of original text
     *
     * @return string
     */
    public static function rightTrim( $text, $stringToTrim ) {
        $lengthToTrim = strlen( $stringToTrim );
        $originalText = $text;

        $text = trim( $text );

        if( substr( $text, -$lengthToTrim ) == $stringToTrim ) {
            return substr( $text, 0, -$lengthToTrim );
        }

        return $originalText;
    }

    /**
     * Removes a string from the start of a text
     *
     * @param string $text          the original text
     * @param string $stringToTrim  the string that should be removed from start of original text
     *
     * @return string
     */
    public static function leftTrim( $text, $stringToTrim ) {
        if ( strpos( $text, $stringToTrim ) === 0) {
            return substr( $text, strlen( $stringToTrim ) );
        }

        return $text;
    }

    /**
     * Check if string ends with another string
     *
     * @param $haystack
     * @param $needle
     *
     * @return bool
     */
    public static function ends( $haystack, $needle ){
        $len = strlen( $needle );
        if ( $len == 0 ) {
            return true;
        }
        return substr( $haystack, -$len ) === $needle;
    }

    /**
     * Check if string starts with another string
     *
     * @param $haystack
     * @param $needle
     *
     * @return bool
     */
    public static function starts( $haystack, $needle ){
        return 0 === strpos( $haystack, $needle );
    }

    /**
     * Converts comma-separated string, empty, or null values to array
     *
     * @param mixed   $value      Variable to be converted
     * @param string  $separator  Separator in text-separated string
     * @return array
     */
    public static function toArray( $value, $separator = ',' ){
        if ( is_null( $value ) || $value === '') {
            return [];
        } elseif ( is_array( $value ) ) {
            return $value;
        } elseif ( is_string( $value ) ) {
            $value = array_map('trim', explode( $separator, $value ) );
            // remove empty items as well
            return array_filter( $value, function( $item ) {
                return !empty( $item );
            });
        } else {
            return [];
        }
    }

}