# --DOCUMENTAZIONE

"""
Autore: Fraccari Luca
Classe: 3AT
Nome programma: scanstr.py
Versione programma: 01_01
Versione Python usata: 3.5.1
Output: Da una stringa presa in input, ritorna la stringa ma "veritcalizzata" in una nuova variabile.
"""


# --VARIABILI


boolD = True
stringa = "fraccari"

"""
Sezione delle variabili globali, reperibili in qualsiasi momento del programma
in 'stringa' abbiamo una scritta con diversi carateri.
'ncar' è il numero dei carattteri, per comodità l'ho inizializzato a zero.
Come sempre la variabile boolD che ci fa capire l'inizio e la fine del nostro programma.
"""


# --FUNZIONI


def str_verticale(t_stringa):

    stringa_output = ""
    ncar = len(t_stringa)
    pos = 0

    while ncar > pos:

        stringa_output = stringa_output + t_stringa[pos] + "\n"
        pos = pos + 1

    return stringa_output


"""
Ora siamo all' interno della sezione funzioni; definiamo 'str_verticale' che prende come argomenti, 2 parametri.
'stringa' ed 'ncar'; inizialmente impostata a zero ma poi verrà
immediatamente aggiornata dal main grazie a: 'ncar = len (stringa)'.
Come variabili locali abbiamo 'pos' che sarebbe il contatore,
 che ci permette di cambiare carattere e procedere con quello successivo.
Inoltre abbiamo 'stringa_output' che essendo appunto relativa
 a una stringa abbiamo inizializzato a (""), il corrispettivo 0.
--
Affinchè 'ncar' è maggiore di 'pos' ripeti il ciclo salvando in 'stringa_output' la somma
di 'stringa_output' e la posizione di un carattere, che verrà
incrementato di uno. Grazie allo '\n' dopo la somma andrà a capo.
Quando 'ncar' sarà uguale a 'pos' darà come valore di ritorno
'stringa_output', (corrisponde alla scritta verticalizzata)
"""


# --ELABORAZIONE


if __name__ == "__main__":

    if boolD:

        print("Inizio")

    print(str_verticale(stringa))

    if boolD:
        print("Fine")

"""
Ora siamo nel main e troviamo i boolD, che se impostati a vero, visualizzeranno 'Inizio' e 'Fine' del programma.
Troviamo poi la variabile 'ncar' e grazie ad una funzione 'len',
che prende in input il nome della variabile, in questo caso 'stringa',
permette di calcolare quanti elementi ci sono all'interno di una determinata stringa.
Abbiamo un print che permette di visualizzare il conenuto della funzione 'str_verticale'.
"""