mirror of
https://github.com/natelandau/shell-scripting-templates.git
synced 2025-11-08 13:13:47 -05:00
b227cf6330
After working for ~6 years in private repositories, bringing my updated BASH scripting templates back into the world.
99 lines
2.8 KiB
Bash
99 lines
2.8 KiB
Bash
_inArray_() {
|
|
# DESC: Determine if a value is in an array
|
|
# ARGS: $1 (Required) - Value to search for
|
|
# $2 (Required) - Array written as ${ARRAY[@]}
|
|
# OUTS: true/false
|
|
# USAGE: if _inArray_ "VALUE" "${ARRAY[@]}"; then ...
|
|
|
|
[[ $# -lt 2 ]] && fatal 'Missing required argument to _inArray_()!'
|
|
|
|
local value="$1"
|
|
shift
|
|
for arrayItem in "$@"; do
|
|
[[ "${arrayItem}" == "${value}" ]] && return 0
|
|
done
|
|
return 1
|
|
}
|
|
|
|
_join_() {
|
|
# DESC: Joins items together with a user specified separator
|
|
# ARGS: $1 (Required) - Separator
|
|
# $@ (Required) - Items to be joined
|
|
# OUTS: Prints joined terms
|
|
# USAGE:
|
|
# _join_ , a "b c" d #a,b c,d
|
|
# _join_ / var local tmp #var/local/tmp
|
|
# _join_ , "${foo[@]}" #a,b,c
|
|
# NOTE: http://stackoverflow.com/questions/1527049/bash-join-elements-of-an-array
|
|
|
|
[[ $# -lt 2 ]] && fatal 'Missing required argument to _join_()!'
|
|
|
|
local IFS="${1}"
|
|
shift
|
|
echo "${*}"
|
|
}
|
|
|
|
_setdiff_() {
|
|
# DESC: Return items that exist in ARRAY1 that are do not exist in ARRAY2
|
|
# ARGS: $1 (Required) - Array 1 in format ${ARRAY[*]}
|
|
# $2 (Required) - Array 2 in format ${ARRAY[*]}
|
|
# OUTS: Prints unique terms
|
|
# USAGE: _setdiff_ "${array1[*]}" "${array2[*]}"
|
|
# NOTE: http://stackoverflow.com/a/1617303/142339
|
|
|
|
[[ $# -lt 2 ]] && fatal 'Missing required argument to _setdiff_()!'
|
|
|
|
local debug skip a b
|
|
if [[ "$1" == 1 ]]; then
|
|
debug=1
|
|
shift
|
|
fi
|
|
if [[ "$1" ]]; then
|
|
local setdiffA setdiffB setdiffC
|
|
# shellcheck disable=SC2206
|
|
setdiffA=($1)
|
|
# shellcheck disable=SC2206
|
|
setdiffB=($2)
|
|
fi
|
|
setdiffC=()
|
|
for a in "${setdiffA[@]}"; do
|
|
skip=
|
|
for b in "${setdiffB[@]}"; do
|
|
[[ "$a" == "$b" ]] && skip=1 && break
|
|
done
|
|
[[ "$skip" ]] || setdiffC=("${setdiffC[@]}" "$a")
|
|
done
|
|
[[ "$debug" ]] && for a in setdiffA setdiffB setdiffC; do
|
|
#shellcheck disable=SC1087
|
|
echo "$a ($(eval echo "\${#$a[*]}")) $(eval echo "\${$a[*]}")" 1>&2
|
|
done
|
|
[[ "$1" ]] && echo "${setdiffC[@]}"
|
|
}
|
|
|
|
_removeDupes_() {
|
|
# DESC: Removes duplicate array elements.
|
|
# ARGS: $1 (Required) - Input array
|
|
# OUTS: Prints de-duped elements to standard out
|
|
# USAGE: _removeDups_ "${array@]}"
|
|
# NOTE: List order may not stay the same.
|
|
# https://github.com/dylanaraps/pure-bash-bible
|
|
declare -A tmp_array
|
|
|
|
for i in "$@"; do
|
|
[[ $i ]] && IFS=" " tmp_array["${i:- }"]=1
|
|
done
|
|
|
|
printf '%s\n' "${!tmp_array[@]}"
|
|
}
|
|
|
|
_randomArrayElement_() {
|
|
# DESC: Selects a random item from an array
|
|
# ARGS: $1 (Required) - Input array
|
|
# OUTS: Prints result
|
|
# USAGE: _randomArrayElement_ "${array[@]}"
|
|
# NOTE: https://github.com/dylanaraps/pure-bash-bible
|
|
# Usage: random_array_element "array"
|
|
local arr=("$@")
|
|
printf '%s\n' "${arr[RANDOM % $#]}"
|
|
}
|