Skip to content

Commit 758fe6d

Browse files
ManueldGManueldG
authored
Updated reference/errorfunc/functions/debug-backtrace.xml (#69)
1 parent 446f6a3 commit 758fe6d

File tree

1 file changed

+101
-52
lines changed

1 file changed

+101
-52
lines changed

‎reference/errorfunc/functions/debug-backtrace.xml‎

Lines changed: 101 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,123 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 201dc3748c7a94e788d470c697f017d2149c6736 Maintainer: cucinato Status: ready -->
2+
<!-- EN-Revision: e203b12d7964aa7c729e1f7c26fcbf357fc9fb63 Maintainer: ManueldG Status: ready -->
3+
<!-- Reviewed: no -->
4+
<!-- CREDITS: cucinato -->
35
<refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook">
46
<refnamediv>
57
<refname>debug_backtrace</refname>
68
<refpurpose>Genera un backtrace</refpurpose>
79
</refnamediv>
8-
10+
911
<refsect1 role="description">
1012
&reftitle.description;
1113
<methodsynopsis>
1214
<type>array</type><methodname>debug_backtrace</methodname>
13-
<methodparam choice="opt"><type>bool</type><parameter>provide_object</parameter><initializer>true</initializer></methodparam>
15+
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer><constant>DEBUG_BACKTRACE_PROVIDE_OBJECT</constant></initializer></methodparam>
16+
<methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>0</initializer></methodparam>
1417
</methodsynopsis>
1518
<para>
16-
<function>debug_backtrace</function> genera un backtrace PHP.
19+
<function>debug_backtrace</function> genera un backtrace di PHP.
1720
</para>
18-
</refsect1>
19-
21+
</refsect1>
22+
2023
<refsect1 role="parameters"><!-- {{{ -->
2124
&reftitle.parameters;
2225
<para>
2326
<variablelist>
2427
<varlistentry>
25-
<term><parameter>provide_object</parameter></term>
28+
<term><parameter>options</parameter></term>
29+
<listitem>
30+
<para>
31+
Questo parametro è una bitmask per le seguenti opzioni:
32+
<table>
33+
<title>Opzioni di <function>debug_backtrace</function></title>
34+
<tgroup cols="2">
35+
<tbody>
36+
<row>
37+
<entry>DEBUG_BACKTRACE_PROVIDE_OBJECT</entry>
38+
<entry>
39+
Indica se popolare o meno l'"oggetto" index.
40+
</entry>
41+
</row>
42+
<row>
43+
<entry>DEBUG_BACKTRACE_IGNORE_ARGS</entry>
44+
<entry>
45+
Indica se omettere o meno gli indici di "args" e quindi tutti gli argomenti della funzione/metodo,
46+
per risparmiare memoria.
47+
</entry>
48+
</row>
49+
</tbody>
50+
</tgroup>
51+
</table>
52+
<note>
53+
<para>
54+
Ci sono quattro possibili combinazioni:
55+
<table>
56+
<title>Opzioni di <function>debug_backtrace</function></title>
57+
<tgroup cols="2">
58+
<tbody>
59+
<row>
60+
<entry><code>debug_backtrace()</code></entry>
61+
<entry morerows="2" valign="middle">
62+
Popola entrambi gli indici
63+
</entry>
64+
</row>
65+
<row>
66+
<entry><code>debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT)</code></entry>
67+
</row>
68+
<row>
69+
<entry><code>debug_backtrace(1)</code></entry>
70+
</row>
71+
<row>
72+
<entry><code>debug_backtrace(0)</code></entry>
73+
<entry valign="middle">
74+
Omette l'indice di <literal>"object"</literal> e popola l'indice di <literal>"args"</literal>.
75+
</entry>
76+
</row>
77+
<row>
78+
<entry><code>debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)</code></entry>
79+
<entry morerows="1" valign="middle">
80+
Omette l'indice <literal>"object"</literal> <emphasis> e </emphasis> l'indice di <literal>"args"</literal>.
81+
</entry>
82+
</row>
83+
<row>
84+
<entry><code>debug_backtrace(2)</code></entry>
85+
</row>
86+
<row>
87+
<entry><code>debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT|DEBUG_BACKTRACE_IGNORE_ARGS)</code></entry>
88+
<entry morerows="1" valign="middle">
89+
Popola l'indice <literal>"object"</literal> <emphasis> e </emphasis> omette l'indice <literal>"args"</literal>.
90+
</entry>
91+
</row>
92+
<row>
93+
<entry><code>debug_backtrace(3)</code></entry>
94+
</row>
95+
</tbody>
96+
</tgroup>
97+
</table>
98+
</para>
99+
</note>
100+
</para>
101+
</listitem>
102+
</varlistentry>
103+
<varlistentry>
104+
<term><parameter>limit</parameter></term>
26105
<listitem>
27106
<para>
28-
Abilita o meno la popolazione dell'indice "object".
107+
Questo parametro può essere utilizzato per limitare il numero di stack frame restituiti.
108+
Per default (<parameter>limit</parameter>=<literal>0</literal>) restituisce tutti gli stack frame.
29109
</para>
30110
</listitem>
31111
</varlistentry>
32112
</variablelist>
33113
</para>
34114
</refsect1><!-- }}} -->
35-
115+
36116
<refsect1 role="returnvalues">
37117
&reftitle.returnvalues;
38118
<para>
39-
Restituisce un <type>array</type> associativo. Gli elementi che possono essere restituiti
40-
sono elencati nella seguente tabella:
119+
Restituisce un array associativo <type>array</type>. Gli elementi che possono essere restituiti
120+
sono elencati nella seguente tabella:
41121
</para>
42122
<para>
43123
<table>
@@ -61,7 +141,7 @@
61141
</row>
62142
<row>
63143
<entry>line</entry>
64-
<entry><type>integer</type></entry>
144+
<entry><type>int</type></entry>
65145
<entry>
66146
Il numero della linea corrente. Vedere anche
67147
<link linkend="language.constants.predefined">__LINE__</link>.
@@ -79,7 +159,7 @@
79159
<entry>class</entry>
80160
<entry><type>string</type></entry>
81161
<entry>
82-
Il nome della <link linkend="language.oop5">class</link> corrente. Vedere anche
162+
Il nome della <link linkend="language.oop5">classe</link> corrente. Vedere anche
83163
<link linkend="language.constants.predefined">__CLASS__</link>
84164
</entry>
85165
</row>
@@ -94,16 +174,16 @@
94174
<entry>type</entry>
95175
<entry><type>string</type></entry>
96176
<entry>
97-
Il tipo di chiamata corrente. Se chiamata di metodo, viene restituito "->" is returned. Se chiamata
98-
di metodo statico, viene restituito "::". Se chiamata di funzione, non viene restituito niente.
177+
Il tipo di chiamata corrente. Se è una chiamata ad un metodo, viene restituito "-&gt;".
178+
Se è una chiamata ad un metodo statico, viene restituito "::". Se è una chiamata ad una funzione, non viene restituito nulla.
99179
</entry>
100180
</row>
101181
<row>
102182
<entry>args</entry>
103183
<entry><type>array</type></entry>
104184
<entry>
105-
Se all'interno di una funzione, elenca gli argomenti della funzione.
106-
Se all'interno di un file incluso, elenca i nomi del file incluso.
185+
Se dentro una funzione, elenca una lista con gli argomenti della funzione.
186+
Se all'interno di un file che è stato incluso, elenca i nomi dei file inclusi.
107187
</entry>
108188
</row>
109189
</tbody>
@@ -112,41 +192,11 @@
112192
</para>
113193
</refsect1>
114194

115-
<refsect1 role="changelog">
116-
&reftitle.changelog;
117-
<para>
118-
<informaltable>
119-
<tgroup cols="2">
120-
<thead>
121-
<row>
122-
<entry>&Version;</entry>
123-
<entry>&Description;</entry>
124-
</row>
125-
</thead>
126-
<tbody>
127-
<row>
128-
<entry>5.2.5</entry>
129-
<entry>
130-
Aggiunto il parametro opzionale <parameter>provide_object</parameter>.
131-
</entry>
132-
</row>
133-
<row>
134-
<entry>5.1.1</entry>
135-
<entry>
136-
Aggiunto l'<type>object</type> corrente come possibile elemento di ritorno.
137-
</entry>
138-
</row>
139-
</tbody>
140-
</tgroup>
141-
</informaltable>
142-
</para>
143-
</refsect1>
144-
145195
<refsect1 role="examples">
146196
&reftitle.examples;
147197
<para>
148198
<example>
149-
<title><function>debug_backtrace</function> example</title>
199+
<title>Esempio di <function>debug_backtrace</function></title>
150200
<programlisting role="php">
151201
<![CDATA[
152202
<?php
@@ -168,8 +218,8 @@ include_once '/tmp/a.php';
168218
]]>
169219
</programlisting>
170220
<para>
171-
Dà risultati simili ai seguenti quando si esegue
172-
<filename>/tmp/b.php</filename>:
221+
Fornisce risultati simili al seguente esempio quando si esegue
222+
<filename>/tmp/b.php</filename>:
173223
</para>
174224
<screen>
175225
<![CDATA[
@@ -201,7 +251,7 @@ array(4) {
201251
</example>
202252
</para>
203253
</refsect1>
204-
254+
205255
<refsect1 role="seealso">
206256
&reftitle.seealso;
207257
<para>
@@ -212,7 +262,6 @@ array(4) {
212262
</para>
213263
</refsect1>
214264
</refentry>
215-
216265
<!-- Keep this comment at the end of the file
217266
Local variables:
218267
mode: sgml

0 commit comments

Comments
 (0)