Teoria Bash 01: Repàs i Funcions

0. Ordres noves i document en html

Ordres noves: local, readonly, tee, basename i shift)
Aquest document en html

1. Repàs de conceptes bàsics

Variables

# Assignació (sense espais!)
nom="Joan"
edat=25

# Ús de variables
echo "Hola $nom"
echo "Tens ${edat} anys"

# Variables d'entorn
export PATH="/usr/local/bin:$PATH"

# Llegir input de l'usuari
read -p "Introdueix el teu nom: " nom

Condicionals

# Sintaxi bàsica
if [ condició ]; then
    # codi
elif [ altra_condició ]; then
    # altre codi
else
    # codi alternatiu
fi

# Operadors de comparació numèrica
# -eq (igual), -ne (diferent), -lt (menor), -le (menor o igual)
# -gt (major), -ge (major o igual)

if [ $edat -ge 18 ]; then
    echo "Ets major d'edat"
fi

# Operadors de comparació de strings
# = (igual), != (diferent), -z (buit), -n (no buit)

if [ "$nom" = "Joan" ]; then
    echo "Hola Joan!"
fi

# Operadors de fitxers
# -f (fitxer existeix), -d (directori existeix)
# -r (llegible), -w (escrivible), -x (executable)

if [ -f "/etc/passwd" ]; then
    echo "El fitxer existeix"
fi

# Operadors lògics
# -a (AND), -o (OR), ! (NOT)
# També es pot usar && i ||

if [ $edat -ge 18 ] && [ "$nom" != "" ]; then
    echo "Dades vàlides"
fi

Bucles

# Bucle for amb llista
for nom in Joan Maria Pere; do
    echo "Hola $nom"
done

# Bucle for amb rang
for i in {1..10}; do
    echo "Número $i"
done

# Bucle for estil C
for ((i=0; i<10; i++)); do
    echo "Comptador: $i"
done

# Bucle while
contador=0
while [ $contador -lt 5 ]; do
    echo "Valor: $contador"
    ((contador++))
done

# Llegir fitxer línia per línia
while IFS= read -r linia; do
    echo "Línia: $linia"
done < fitxer.txt

2. Funcions en Bash

Definició de funcions

Hi ha dues sintaxis per definir funcions:

# Sintaxi 1 (més comuna)
nom_funcio() {
    # codi de la funció
}

# Sintaxi 2
function nom_funcio {
    # codi de la funció
}

Exemple bàsic

#!/bin/bash

saludar() {
    echo "Hola des de la funció!"
}

# Cridar la funció
saludar

Paràmetres de funcions

Les funcions reben paràmetres igual que els scripts:

saludar() {
    echo "Hola $1!"
    echo "Tens $2 anys"
}

# Cridar amb paràmetres
saludar "Joan" 25

# Variables especials per a paràmetres:
# $1, $2, $3... - paràmetres individuals
# $@ - tots els paràmetres com a paraules separades
# $* - tots els paràmetres com a una sola cadena
# $# - nombre de paràmetres

Exemple amb múltiples paràmetres

mostrar_info() {
    echo "Nombre de paràmetres: $#"
    echo "Primer paràmetre: $1"
    echo "Segon paràmetre: $2"
    echo "Tots els paràmetres: $@"
}

mostrar_info un dos tres quatre

Retornar valors

En Bash, les funcions no retornen valors com en altres llenguatges. Hi ha dues maneres principals:

1. Usar INLINECODE0 (només per a codis d'estat 0-255)

es_parell() {
    local num=$1
    if [ $((num % 2)) -eq 0 ]; then
        return 0  # èxit (true)
    else
        return 1  # error (false)
    fi
}

# Comprovar el resultat
if es_parell 4; then
    echo "4 és parell"
fi

# O capturar el codi de retorn
es_parell 5
resultat=$?
echo "Codi de retorn: $resultat"

2. Usar INLINECODE1 (per retornar dades)

sumar() {
    local a=$1
    local b=$2
    local suma=$((a + b))
    echo $suma
}

# Capturar el resultat amb $()
resultat=$(sumar 5 3)
echo "La suma és: $resultat"

Scope de variables: INLINECODE2 vs global

# Variable global
variable_global="Sóc global"

funcio_exemple() {
    # Variable local (només visible dins la funció)
    local variable_local="Sóc local"

    # Modificar variable global
    variable_global="He estat modificada"

    echo "Dins la funció:"
    echo "  Global: $variable_global"
    echo "  Local: $variable_local"
}

funcio_exemple

echo "Fora de la funció:"
echo "  Global: $variable_global"
echo "  Local: $variable_local"  # Estarà buida!

Bones pràctiques:

Sempre usar INLINECODE3 per a variables dins de funcions
Només usar variables globals quan calgui compartir estat
Noms descriptius per a les funcions

Exemple complet d'una funció útil

#!/bin/bash

# Funció que comprova si un fitxer existeix i és llegible
comprovar_fitxer() {
    local fitxer=$1

    if [ -z "$fitxer" ]; then
        echo "Error: Cal especificar un fitxer"
        return 1
    fi

    if [ ! -f "$fitxer" ]; then
        echo "Error: El fitxer $fitxer no existeix"
        return 2
    fi

    if [ ! -r "$fitxer" ]; then
        echo "Error: El fitxer $fitxer no és llegible"
        return 3
    fi

    echo "El fitxer $fitxer és vàlid"
    return 0
}

# Exemple d'ús
comprovar_fitxer "/etc/passwd"
echo "Codi de retorn: $?"

comprovarfitxer "/fitxerinexistent"
echo "Codi de retorn: $?"

Funcions amb validació de paràmetres

dividir() {
    # Comprovar que tenim 2 paràmetres
    if [ $# -ne 2 ]; then
        echo "Error: Cal proporcionar exactament 2 números"
        return 1
    fi

    local dividend=$1
    local divisor=$2

    # Comprovar divisió per zero
    if [ $divisor -eq 0 ]; then
        echo "Error: No es pot dividir per zero"
        return 2
    fi

    # Fer la divisió
    local resultat=$((dividend / divisor))
    echo $resultat
    return 0
}

# Ús
resultat=$(dividir 10 2)
if [ $? -eq 0 ]; then
    echo "Resultat: $resultat"
fi

3. Organització del codi amb funcions

Estructura recomanada d'un script

#!/bin/bash

#############################################
# Script: exemple.sh
# Descripció: Exemple d'estructura de script
# Autor: El teu nom
# Data: 2024-01-08
#############################################

# Variables globals
readonly SCRIPTDIR="$(cd "$(dirname "${BASHSOURCE[0]}")" && pwd)"
readonly LOG_FILE="/var/log/script.log"

#############################################
# Funcions auxiliars
#############################################

mostrar_ajuda() {
    cat << EOF
Ús: $(basename $0) [opcions]

Opcions:
    -h, --help      Mostra aquesta ajuda
    -v, --verbose   Mode verbós
    -f FITXER       Especifica un fitxer
EOF
}

log() {
    local missatge=$1
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $missatge" | tee -a "$LOG_FILE"
}

#############################################
# Funcions principals
#############################################

processar_dades() {
    local fitxer=$1
    log "Processant $fitxer..."
    # Codi de processament aquí
}

#############################################
# Programa principal
#############################################

main() {
    # Comprovar arguments
    if [ $# -eq 0 ]; then
        mostrar_ajuda
        exit 1
    fi

    # Processar opcions
    while [ $# -gt 0 ]; do
        case $1 in
            -h|--help)
                mostrar_ajuda
                exit 0
                ;;
            -f)
                processar_dades "$2"
                shift 2
                ;;
            *)
                echo "Opció desconeguda: $1"
                mostrar_ajuda
                exit 1
                ;;
        esac
    done
}

# Executar programa principal
main "$@"

4. Ús de colors al terminal

Exemple d'ús de colors

# Definició de colors (ANSI)
readonly CL_VERD='\033[0;32m'
readonly CL_VERMELL='\033[0;31m'
readonly CL_GROC='\033[0;33m'
readonly CL_RESET='\033[0m' # Torna al color normal
readonly LOG_FILE="nouLog.log"

log() {
    local nivell=$1
    local missatge=$2
    local data=$(date '+%Y-%m-%d %H:%M:%S')
    local color=""

    # Escollir color segons el nivell
    case "$nivell" in
        "INFO")  color=$CL_VERD ;;
        "ERROR") color=$CL_VERMELL ;;
        "WARN")  color=$CL_GROC ;;
        *)       color=$CL_RESET ;;
    esac

    # 1. Imprimir a la pantalla AMB colors
    echo -e "${color}[$data] [$nivell] $missatge${CL_RESET}"

    # 2. Guardar al fitxer SENSE colors (perquè sigui llegible amb qualsevol editor)
    echo "[$data] [$nivell] $missatge" >> "$LOG_FILE"
}

# --- Mock de funcionament ---
log "INFO" "El sistema s'ha iniciat correctament."
log "WARN" "L'espai de disc és inferior al 10%."
log "ERROR" "No s'ha pogut escriure al directori de destí."

5. Consells i bones pràctiques

Sempre usar INLINECODE4''' per a variables dins de funcions
Validar paràmetres abans de processar-los
Retornar codis d'error significatius (0 = èxit, >0 = error)
Documentar les funcions amb comentaris
Usar noms descriptius per a funcions i variables
Evitar efectes secundaris quan sigui possible
Una funció, una tasca (principi de responsabilitat única)

Resum

Les funcions organitzen el codi en blocs reutilitzables
Reben paràmetres amb INLINECODE5, INLINECODE6, etc.
Retornen codis amb INLINECODE7 (0-255)
Retornen dades amb INLINECODE8 i captura amb INLINECODE9
Usar INLINECODE10 per a variables dins de funcions
Sempre validar paràmetres i gestionar errors

Teoria Bash 01: Repàs i Funcions

Contingut

Teoria Bash 01: Repàs i Funcions

0. Ordres noves i document en html

1. Repàs de conceptes bàsics

Variables

Condicionals

Bucles

2. Funcions en Bash

Definició de funcions

Exemple bàsic

Paràmetres de funcions

Exemple amb múltiples paràmetres

Retornar valors

1. Usar INLINECODE0 (només per a codis d'estat 0-255)

2. Usar INLINECODE1 (per retornar dades)

Scope de variables: INLINECODE2 vs global

Exemple complet d'una funció útil

Funcions amb validació de paràmetres

3. Organització del codi amb funcions

Estructura recomanada d'un script

4. Ús de colors al terminal

Exemple d'ús de colors

5. Consells i bones pràctiques

Resum

Menú de navegació

Eines de l'usuari

Espais de noms

Variants

Vistes

Més

Cerca

Navegació

Eines