Manuale PHP
Indietro | Appendice R. Informazioni sul manuale | Avanti

# Come leggere la definizione di una funzione (prototipo)

Nel manuale ciascuna funzione è documentata per un rapido riferimento. Conoscendo come leggere e capendo il testo si è in grado di apprendere il PHP molto più facilmente. Piuttosto che appoggiarsi sugli esempi o sul copia e incolla, preferirai sicuramente sapere come leggere la definizione di una funzione. Cominciamo:

> Pre-requisito: comprensione di base dei tipi di variabili: Sebbene il PHP sia un linguaggio poco tipizzato (loosely typed), è importante avere una conoscenza di base delle tipologie di variabili per il loro importante significato.

La definizione della funzione ci dice quale tipo di valore viene restituito. Utilizziamo la definizione di strlen() come nostro primo esempio:

    strlen

    (PHP 3, PHP 4, PHP 5)
    strlen -- Restituisce la lunghezza di una stringa

    Description
    int strlen ( string str )

    Restituisce la lunghezza di una stringa.

Tabella R-1. Spiegazione della definizione di una funzione

Parte | Descrizione
--- | ---
strlen | Nome della funzione.
(PHP 3, PHP 4, PHP 5) | strlen() è disponibile in tutte le versioni di PHP 3, PHP 4 e PHP 5
int | Tipo di valore restituito dalla funzione, il quale è un intero (la lunghezza di una stringa si misura in numei).
( string str ) | Il primo (ed in questo caso unico) parametro/argomento per questa funzione si chiama str, ed è una stringa.

Si potrebbe riscrivere la funzione precedente in modo generico:

    returned type    function name    ( parameter type   parameter name )

Diverse funzioni hanno diversi parametri, tipo in_array(). Il loro prototipo è:

    bool in_array ( mixed needle, array haystack [, bool strict])

Cosa significa? in_array() restituisce un valore boolean value, `TRUE` se riesce (se il parametro needle viene trovato in haystack) oppure `FALSE` se fallisce (se il parametro needle non viene trovato in haystack). Il primo parametro si chiama needle e può essere di diversi tipi, pertanto lo chiameremo "mixed". Questo parametro needle di tipo mixed (che indica che il valore che stiamo cercando) può essere sia un valore scalare (stringa, intero, oppure float), sia una matrice. haystack (che indica la variabile in cui cercare) è il secondo parametro. Il terzo parametro opzionale è chiamato strict. Tutti i parametri opzionali sono racchiusi tra parentesi [ quadre ]. Il manuale indica che il valore di defualt per strict è il boolean `FALSE`. Vedere le pagine del manuale di ciascuna funzione per i dettagli di come funziona.

Esistono anche funzioni con complesse informazioni sulla versione PHP. Ad esempio la funzione html_entity_decode():

    (PHP 4 >= 4.3.0, PHP 5)

Questo significa che questa funzione non era disponibile con il PHP 3, ed è soltanto disponibile a partire dalla release PHP 4.3.0.

Indietro | Partenza | Avanti
Contributi degli utenti | Risali | Le versioni di PHP documentate in questo manuale