From 6df6f16c61839c07d8242b70c41f01132c5defad Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Mar 2025 21:26:50 +0100
Subject: [PATCH 1/2] first traduction dirname
---
reference/filesystem/functions/dirname.xml | 243 +++++++++++++++------
1 file changed, 171 insertions(+), 72 deletions(-)
diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml
index edaab5522..f3a794fd8 100644
--- a/reference/filesystem/functions/dirname.xml
+++ b/reference/filesystem/functions/dirname.xml
@@ -1,82 +1,181 @@
-
-
-
-
-
- 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.
+
+ On Windows, dirname assumes the currently set codepage, so for it to see the
+ correct directory name with multibyte character paths, the matching codepage must
+ be set.
+ If path contains characters which are invalid for the
+ current codepage, the behavior of dirname is undefined.
+
+
+ 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 barre in
+ path, viene restituito un punto ('.'), che
+ indica la directory corrente. In caso contrario, la stringa restituita è
+ path con qualsiasi
+ /component finale rimosso.
+
+
+
+
+ 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.changelog;
+
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 7.0.0
+
+ Aggiunto il parametro optionale levels.
+
+
+
+
+
+
+
+
+
+ &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
+
+
+
+
+
+
+
-
+
dirname
@@ -34,12 +35,6 @@
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.
-
- On Windows, dirname assumes the currently set codepage, so for it to see the
- correct directory name with multibyte character paths, the matching codepage must
- be set.
- If path contains characters which are invalid for the
- current codepage, the behavior of dirname is undefined.
negli altri sistemi operativi, nella funzione dirname si presume che path
@@ -84,11 +79,11 @@
&reftitle.returnvalues;
- Restituisce il percorso di una directory padre. Se non ci sono barre in
+ 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 con qualsiasi
- /component finale rimosso.
+ path senza qualsiasi
+ /component finale.
@@ -111,30 +106,6 @@ dirname('C:\\'); // Restituirà 'C:\' su Windows e '.' su sistemi *nix.
-
- &reftitle.changelog;
-
-
-
-
-
- &Version;
- &Description;
-
-
-
-
- 7.0.0
-
- Aggiunto il parametro optionale levels.
-
-
-
-
-
-
-
-
&reftitle.examples;