Capitolo 3: Note sulla programmazione
con le API
Indice
3.1.
Uso del void
3.1. Uso del void
Durante l'API Reference, viene
fatto uso di un tipo void(vuoto), specialmente per i valori di
ritorno specifici. PHP in sè non ha un tipo di void, esso è
usato in questo documento per riferirsi al valore di unset. Questo è
molto importante affinchè capiscano questa differenza poiché
il parametro vuoto è usato pesante dal sistema di trattamento
delle eccezioni su cui le funzioni dell'API di Envolution sono
basate.
Per esempio, il pnModAPIFunc()
prende i parametri di un nome del modulo, tipo e la funzione, risolve
che funzione attuale del modulo da chiamare; allora chiama la
funzione del modulo e passa indietro il valore di ritorno come i suoi
propri valori di ritorno. Il problema con questo è che se
pnModAPIFunc() restituisce false a causa del fallimento della ricerca
della fuzione specificata allora allo sviluppatore questo diventa
indistinguibile dalla funzione che è trovata ed in se i valori
false di rinvio e void di ritorno possono essere controllati con la
funzione del isset() di PHP, come indicato qui sotto:
|
$articles
= pnModAPIFunc('News', 'user', 'getarticles');
if
(!isset($articles) && pnExceptionMajor() !=
PN_NO_EXCEPTION) {
// pnModAPIFunc() failed
return; // throw back exception
}
if
($articles == false)
// getarticles failed
}
else {
// getarticles succeeded, data in $articles
}
|
Durante la reference dell'API di
Envolution i valori di ritorno di void e di false sono diversi. false
è ritornato quando una chiamata di API ha funzionato
correttamente ma è ritornata una risposta negativa, void è
restituito quando una chiamata di API ha problemi interni e solleva
un'eccezione. Si noti che questa è una regola generale e ci
sono alcune eccezioni dalla necessità. Queste eccezioni sono
notate nella documentazione di riferimento per la funzione relativa.
