Class: StrUtils

Namespace: utils

Description

Classe estática com métodos para trabalhar com strings.

@todo Garantir que a codificação interna é UTF-8 >> mb_internal_encoding("UTF-8");

Methods

Retorna uma parte da string informada de acordo com os parâmetros estabelecidos Obs.: se $string for vazio ou nulo, retorna uma string vazia.

@param null|string $string Texto principal

@param null|int $start Posição inicial da parte (posição inicial igual a 0)

@param null|int $length Tamanho da parte (se não informada, retorna o resto da string a partir de $start)

public static function substr(?string $string, ?int $start = 0, ?int $length = null): string

Parameters:

• $string (?string)
• $start (?int) - Default: 0
• $length (?int) - Default: null

Retorna uma parte do texto de acordo com o limite de caracterres Obs.: se o limite for aplicado e a última palavra estiver "cortada", retorna a partir do último espaço em branco.

@param null|string $texto Texto original

@param null|int $limite Limite em caracteres

@param null|string $sufixo sufixo adicionado ao final do corte

public static function limitarTexto($texto, $limite, $sufixo = ''): string

Parameters:

• $texto
• $limite
• $sufixo - Default: ''

Converte uma string para maiúscula.

public static function toUpper(?string $str): string

Parameters:

• $str (?string)

Converte uma string para minúscula.

@param null|string $str String que será convertida

public static function toLower(?string $str): string

Parameters:

• $str (?string)

@todo Verifica se o texto começa com o subtexto especifico

@param null|string $haystack String principal

@param null|string $needle Substring a ser verificada no inicio da $haystack

@param null|bool $caseSensitive Se a comparação deve diferenciar caracteres maiúsculas e minúsculas

public static function startsWith(?string $haystack, ?string $needle, ?bool $caseSensitive = false): bool

Parameters:

• $haystack (?string)
• $needle (?string)
• $caseSensitive (?bool) - Default: false

@todo Verifica se o texto termina com subtexto especifico

@param mixed $haystack String principal

@param mixed $needle Substring a ser verificada no inicio da $haystack

@param null|bool $caseSensitive Se a comparação deve diferenciar caracteres maiúsculas e minúsculas

public static function endsWith(?string $haystack, ?string $needle, ?bool $caseSensitive = false): bool

Parameters:

• $haystack (?string)
• $needle (?string)
• $caseSensitive (?bool) - Default: false

Retorna o texto a esquerda da posição especificada na string.

@param string $str String

@param null|int $length Posição de delimitação

public static function left(string $str, ?int $length): string

Parameters:

• $str (string)
• $length (?int)

Retorna o texto a direita da posição especificada na string.

@param string $str String

@param null|int $length Posição de delimitação

public static function right(string $str, ?int $length): string

Parameters:

• $str (string)
• $length (?int)

Substitui todas as ocorrecias de um subtext por uma string de substituição.

@param array|string $search O valor a ser buscado

@param array|string $replace Valor que sera usado como substituto

@param array|string $onText Texto onde será efetuada a busca

@return array|string

public static function replace($search, $replace, $onText)

Parameters:

• $search
• $replace
• $onText

Retorna se uma string contem a substring ou não.

@param string $mystring - String principal

@param string $findme - Termo a ser buscado na string principal

public static function contains(string $mystring, string $findme): bool

Parameters:

• $mystring (string)
• $findme (string)

Remove quebras e tabs Usado para obter json válido que está com quebras (vindo do banco de dados) ou para reduzir tamanho do html.

@param mixed $myString

@param mixed $removeDoubleSpace

public static function removeBreaks($myString, $removeDoubleSpace = true)

Parameters:

• $myString
• $removeDoubleSpace - Default: true

Retorna somente os caracteres imprimíveis It matches anything in range 0-31, 127-255 and removes it. https://stackoverflow.com/questions/1176904/how-to-remove-all-non-printable-characters-in-a-string Também remove aspas, apóstrofo e crase.

@param mixed $myString

@param mixed $removeCraseAspasApostrofos

public static function getPrintableCharacters($myString, $removeCraseAspasApostrofos = true)

Parameters:

• $myString
• $removeCraseAspasApostrofos - Default: true

Converte uma string de texto/frase para um texto SNAKE_CASE_UPPERCASE (Sem caracter especial).

public static function convertTextToLiteralIndex(string $string): string

Parameters:

• $string (string)

Converte uma string em 'ISO-8859-1' para 'UTF-8' Obs.: método criado para cobrir depreciação do método nativo utf8_encode().

public static function utf8Encode(?string $str): string

Parameters:

• $str (?string)