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 - (/). - - - - <function>dirname</function> 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; + + + <function>dirname</function> 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 + + + + +