-
Notifications
You must be signed in to change notification settings - Fork 7
/
is-scalar.xml
147 lines (139 loc) · 3.68 KB
/
is-scalar.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ddfd04b767a0dbbdd403bc8e59ee737893b690a2 Maintainer: pastore Status: ready -->
<!-- CREDITS: darvina -->
<refentry xml:id="function.is-scalar" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>is_scalar</refname>
<refpurpose>
Verifica se la variabile è di tipo scalare
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>is_scalar</methodname>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Verifica se la data variabile sia di tipo scalare
</para>
<para>
Le variabili scalari sono quelle contenenti valori di tipo <type>integer</type>,
<type>float</type>, <type>string</type> oppure <type>boolean</type>.
I tipi <type>array</type>, <type>object</type> e <type>resource</type>
non sono scalari.
</para>
<note>
<para>
La funzione <function>is_scalar</function> non considera il tipo <type>resource</type>
come valore scalare, dato che il tipo <type>resource</type> è una tipologia di dato astratto
che attualmente si basa su interi. Tuttavia non ci si può basare su questo
tipo di implementazione, in futuro potrebbe cambiare.
</para>
</note>
<note>
<para>
<function>is_scalar</function> non considera NULL come valore scalare.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>var</parameter></term>
<listitem>
<para>
La variabile da valutare.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Restituisce &true; se la variabile indicata dal parametro <parameter>var</parameter> è di tipo scalare,
in caso contrario restituisce &false;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Esempio di uso di <function>is_scalar</function></title>
<programlisting role="php">
<!-- TODO: better example, this one can be quite misleading for unexperienced
programmers. -->
<![CDATA[
<?php
function show_var($var)
{
if (is_scalar($var)) {
echo $var;
} else {
var_dump($var);
}
}
$pi = 3.1416;
$proteins = array("hemoglobin", "cytochrome c oxidase", "ferredoxin");
show_var($pi);
show_var($proteins)
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
3.1416
array(3) {
[0]=>
string(10) "hemoglobin"
[1]=>
string(20) "cytochrome c oxidase"
[2]=>
string(10) "ferredoxin"
}
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>is_float</function></member>
<member><function>is_int</function></member>
<member><function>is_numeric</function></member>
<member><function>is_real</function></member>
<member><function>is_string</function></member>
<member><function>is_bool</function></member>
<member><function>is_object</function></member>
<member><function>is_array</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->