strings

#!/usr/bin/env bash
#
# ############################################################################
# Project: xSHELL (none)
# File...: strings
# Created: Friday, 2021/05/21 - 21:09:41
# Author.: Fabiano Matos, fgm (fabiano.matoz@gmail.com)
# ~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~~·~·~·~·~·~·~·~
# Last Modified: Tuesday, 2025/02/18 - 01:27:08
# Modified By..: @fbnmtz, (fabiano.matoz@gmail.com)
# ~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~~·~·~·~·~·~·~·~
# Version: 0.1.5.109
# ~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~·~·~·~·~·~·~·~~·~·~·~·~·~~·~·~·~·~·~·~·~
# Description: 
#  >
# ############################################################################
# HISTORY:
#

_xLIB_STRINGS_=true

# split a string by a ginver char
# @param $1 - string to be splited
# @param $2 - split in this char (it will be removed)
# @return $array - string splited
str.split(){
    local array=( $(echo "$1" | tr -s "$2" ' ') )
    echo "${array[@]}"
}

# convert string to a array with each char
str.chars(){
    local array=( $(echo "$1" | fold -w1 | tr -s '\n' ' ') )
    echo "${array[@]}"
}

# get SIZE of a str
str.len(){ echo "${#1}"; }
str.size(){ str.len "$@"; }

# reverse a str
str.reverse(){ echo "$1" | rev; }
str.rev(){ str.reverse $1; }

# change case of a string 
str.upcase(){ echo "$1" | tr a-z A-Z ; }

str.lowcase(){ echo "$1" | tr A-Z a-z ; }

# check if a string contains another string
# @param $1: string alvo da busca
# @param $2: texto a ser pesquisado na string
str.include?(){
    local string=$1; reqsubstr=$2;
    if [[ "${string}" =~ ${reqsubstr} ]]; then 
    # if [ -z "${string##*$reqsubstr*}" ]; then 
        # echo "true"
        return 0
    else
        # echo "false"
        return 1
    fi
}