diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml
index edaab5522..e686f316d 100644
--- a/reference/filesystem/functions/dirname.xml
+++ b/reference/filesystem/functions/dirname.xml
@@ -1,82 +1,152 @@
-
+
-
-
-
- dirname
- Restituisce il nome della directory dal percorso indicato
-
-
- Descrizione
-
- stringdirname
- stringpath
-
-
- Data una stringa contenente il percorso di un file, questa funzione
- restituirà il nome della directory.
-
-
- Su windows sia gli slash (/) che i backslash
- (\) vengono utilizzati come caratteri di separazione nei
- percorsi. In altri ambienti, c'è solo lo slash in avanti
- (/).
-
-
-
- dirname example
-
+
+
+
+
+
+ dirname
+ Ritorna il path del livello superiore della directory
+
+
+
+ &reftitle.description;
+
+ stringdirname
+ stringpath
+ intlevels1
+
+
+ Data una stringa contenente il percorso di un file o una directory, questa funzione
+ restituirà il percorso della directory superiore
+ levels più in su della directory corrente.
+
+
+
+ dirname opera nativamente sulla stringa d'ingresso,
+ e senza conoscere l'attuale filesystem, o componenti del percorso
+ come "..".
+
+
+
+
+ In Windows, dirname presuppone la codepage attualmente
+ impostata, quindi affinché veda il nome di directory corretto con percorsi
+ di caratteri multibyte, deve essere impostata la codepage corrispondente.
+ Se path contiene caratteri non validi per la codepage
+ corrente, il comportamento di dirname non è definito.
+
+
+ negli altri sistemi operativi, nella funzione dirname si presume che path
+ dev'essere in un formato ASCII compatibile. Altrimenti il comportamnto
+ della funzione è imprevedibile.
+
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ path
+
+
+ A path.
+
+
+ Su Windows, sia slash (/) che backslash
+ (\) sono usati come separatore di directory. In
+ altri ambienti, è lo slash (/).
+
+
+
+
+ levels
+
+
+ Il numero di livelli da salire.
+
+
+ Questo dev'essere un'intero maggiore di 0.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Restituisce il percorso di una directory padre. Se non ci sono slash in
+ path, viene restituito un punto ('.'), che
+ indica la directory corrente. In caso contrario, la stringa restituita è
+ path senza qualsiasi
+ /component finale.
+
+
+
+
+ Fai attenzione quando usi questa funzione in un ciclo che può raggiungere
+ la directory di livello superiore perché potrebbe causare un ciclo infinito.
+
+
]]>
-
-
-
-
-
- In PHP 4.0.3, la funzione dirname è stata modificata per essere conforme alle specifiche
- POSIX. Essenzialmente ciò significa che non ci sono slash
- nel parametro path , viene restituito un punto
- ('.') per indicare la directory
- corrente. In altro modo, la stringa restituita è
- path senza alcun
- /component. Occorre notare che ciò implica che spesso
- dalla funzione dirname si ottiene uno slash od un punto nei casi
- in cui la vecchia versione avrebbe restituito una
- stringa vuota.
-
-
-
- dirname ha modificato il suo comportamento dal PHP 4.3.0.
- Controllare l'esempio:
-
-
+
+
+
+
+
+
+
+ &reftitle.examples;
+
+
+ dirname Esempio
+
+echo dirname("/etc/passwd") . PHP_EOL;
+echo dirname("/etc/") . PHP_EOL;
+echo dirname(".") . PHP_EOL;
+echo dirname("C:\\") . PHP_EOL;
+echo dirname("/usr/local/lib", 2);
+]]>
+
+ &example.outputs.similar;
+
+
-
-
-
-
- dirname è sicura con i dati binari dal PHP 5.0.0
-
-
- Vedere anche: basename, pathinfo e
- realpath.
-
-
-
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ basename
+ pathinfo
+ realpath
+
+
+
+
+