cvs: phpdoc-ro /reference/array/functions array-chunk.xml array-diff.xml
| From: | Simion Onea | Date: | Fri, 06 Jun 2008 06:56:20 +0000 |
| Subject: | cvs: phpdoc-ro /reference/array/functions array-chunk.xml array-diff.xml | ||
| Groups: | php.doc.ro | ||
| Request: | Send a blank email to doc-ro+get-467@lists.php.net to get a copy of this message | ||
simionea Fri Jun 6 06:56:20 2008 UTC
Modified files:
/phpdoc-ro/reference/array/functions array-chunk.xml array-diff.xml
Log:
Updated the file.
http://cvs.php.net/viewvc.cgi/phpdoc-ro/reference/array/functions/array-chunk.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ro/reference/array/functions/array-chunk.xml diff -u phpdoc-ro/reference/array/functions/array-chunk.xml:1.6 phpdoc-ro/reference/array/functions/array-chunk.xml:1.7 --- phpdoc-ro/reference/array/functions/array-chunk.xml:1.6 Tue Sep 18 13:38:22 2007 +++ phpdoc-ro/reference/array/functions/array-chunk.xml Fri Jun 6 06:56:20 2008 @@ -1,47 +1,97 @@ -<?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.0 Maintainer: adiju Status: outdated --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_chunk</refname> - <refpurpose>Împarte un tablou în mai multe tablouri</refpurpose> - </refnamediv> - <refsect1> - <title>Descriere</title> - <methodsynopsis> - <type>array</type><methodname>array_chunk</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam> - </methodsynopsis> - <para> - <function>array_chunk</function> împarte un tablou în - mai multe tablouri, fiecare având cel mult <parameter>size</parameter> valori. - Unul dintre tablourile returnate poate avea mai puþine valori - la sfîrºit. Tablourile rezultate vor face parte dintr-un - tablou multidimensional cu index numeric care începe - de la zero. - </para> - <para> - Prin setarea parametrului opþional <parameter>preserve_keys</parameter> - ca &true;, PHP poate fi forþat sã pãstreze indecºii originali - din tabloul iniþial. Dacã se specificã &false; în fiecare tablou - rezultat vor fi utilizaþi indecºi numerici noi - pornind de la zero. Valoarea implicitã este &false;. - </para> - <example> - <title>Exempul de utilizare <function>array_chunk</function></title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: simionea Status: translated --> +<!-- CREDITS: adiju --> +<refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_chunk</refname> + <refpurpose>Desparte un tablou în porÅ£iuni</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>array_chunk</methodname> + <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam> + </methodsynopsis> + <para> + Desparte un tablou în porÅ£iuni de dimensiunea <parameter>size</parameter>. + Ultima porÅ£iune poate sÄ conÅ£inÄ mai puÅ£ine elemente decât + <parameter>size</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + + <varlistentry> + <term><parameter>input</parameter></term> + <listitem> + <para> + Tabloul cu care se lucreazÄ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>size</parameter></term> + <listitem> + <para> + Dimensiunea fiecÄrei porÅ£iuni + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>preserve_keys</parameter></term> + <listitem> + <para> + Când este stabilit în &true; cheile vor fi pÄstrate. + Implicit sete &false;, ceea ce va reindexa numeric porÅ£iunea + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ãntoarce un tablou multidimensional indexat numeric, începând cu zero, + fiecare dimensiune conÅ£inând <parameter>size</parameter> elemente. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + DacÄ <parameter>size</parameter> este mai mic decât 1 va fi emisÄ o eroare + <constant>E_WARNING</constant> Åi se va întoarce &null;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemplu <function>array_chunk</function></title> + <programlisting role="php"> <![CDATA[ +<?php $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); -print_r(array_chunk($input_array, 2, TRUE)); +print_r(array_chunk($input_array, 2, true)); +?> ]]> - </programlisting> - <para> - Rezultatul va fi: - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -84,11 +134,11 @@ ) ]]> - </screen> - </para> - </example> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-ro/reference/array/functions/array-diff.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ro/reference/array/functions/array-diff.xml diff -u phpdoc-ro/reference/array/functions/array-diff.xml:1.5 phpdoc-ro/reference/array/functions/array-diff.xml:1.6 --- phpdoc-ro/reference/array/functions/array-diff.xml:1.5 Tue Sep 18 13:38:22 2007 +++ phpdoc-ro/reference/array/functions/array-diff.xml Fri Jun 6 06:56:20 2008 @@ -1,62 +1,137 @@ -<?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.0 Maintainer: adiju Status: outdated --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> - <refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_diff</refname> - <refpurpose>Calculeazã diferenþa tablourilor</refpurpose> - </refnamediv> - <refsect1> - <title>Descriere</title> - <methodsynopsis> - <type>array</type><methodname>array_diff</methodname> - <methodparam><type>array</type><parameter>array1</parameter></methodparam> - <methodparam><type>array</type><parameter>array2</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> - </methodsynopsis> - <para> - <function>array_diff</function> returneazã un tablou - ce conþine toate valorile din <parameter>array1</parameter> - care nu sunt prezente în celelalte argumente. - Indecºii sunt pãstraþi. - </para> - <para> - <example> - <title>Exemplu de utilizare <function>array_diff</function></title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.16 Maintainer: simionea Status: translated --> +<!-- CREDITS: adiju --> +<refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_diff</refname> + <refpurpose>CalculeazÄ diferenÅ£a dintre tablouri</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>array_diff</methodname> + <methodparam><type>array</type><parameter>array1</parameter></methodparam> + <methodparam><type>array</type><parameter>array2</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> + </methodsynopsis> + <para> + ComparÄ <parameter>array1</parameter> cu <parameter>array2</parameter> Åi + întoarce diferenÅ£a. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array1</parameter></term> + <listitem> + <para> + Tabloul de referinÅ£Ä + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>array2</parameter></term> + <listitem> + <para> + Tabloul care se comparÄ + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + Mai multe tablouri pentru a se compara + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ãntoarce un <type>array</type> ce conÅ£ine toate înregistrÄrile din + <parameter>array1</parameter> care nu sunt prezente nici în unul din + celelalte tablouri. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemplu <function>array_diff</function></title> + <programlisting role="php"> <![CDATA[ -$array1 = array ("a" => "green", "red", "blue", "red"); -$array2 = array ("b" => "green", "yellow", "red"); -$result = array_diff ($array1, $array2); +<?php +$array1 = array("a" => "green", "red", "blue", "red"); +$array2 = array("b" => "green", "yellow", "red"); +$result = array_diff($array1, $array2); + +print_r($result); +?> ]]> - </programlisting> - </example> - </para> - <para> - Variabila <varname>$result</varname> va conþine - <literal>array ("blue");</literal>. Mai multe apariþii ale aceleaºi valori în - $array1 sunt tratate în acelaºi fel. - </para> - <note> - <simpara> - Douã elemente sunt considerate egale dacã ºi numai dacã - <literal>(string) $elem1 === (string) $elem2</literal>. Cu alte cuvinte: - atunci când reprezentãrile ca ºiruri a celor douã valori sunt identice. - <!-- TODO: example of it... --> - </simpara> - </note> - <warning> - <simpara> - Aceastã funcþie nu a funcþionat în PHP 4.0.4! - <!-- TODO: when exactly was this broken?... --> - </simpara> - </warning> + </programlisting> <para> - Vezi de asemenea ºi <function>array_intersect</function>. + ApariÅ£iile multiple în $array1 sunt toate tratate în acelaÅi mod. + Aceasta va afiÅa : </para> - </refsect1> - </refentry> + <screen> +<![CDATA[ +Array +( + [1] => blue +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + DouÄ elemente sunt considerate egale dacÄ Åi numai dacÄ <literal>(string) + $elem1 === (string) $elem2</literal>. Ãn cuvinte: dacÄ reprezentarea lor + ca Åiruri de caractere este aceeaÅi. + <!-- TODO: example of it... --> + </para> + </note> + <note> + <para> + AceastÄ funcÅ£ie verificÄ numai o dimensiune a unui tablou n-dimensional. + Desigur cÄ puteÅ£i sÄ verificaÅ£i dimensiunile mai adânci utilizând + <literal>array_diff($array1[0], $array2[0]);</literal>. + </para> + </note> + <warning> + <simpara> + Aceasta era greÅit în PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>array_diff_assoc</function></member> + <member><function>array_intersect</function></member> + <member><function>array_intersect_assoc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-ro/reference/array/functions/array-chunk.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ro/reference/array/functions/array-chunk.xml diff -u phpdoc-ro/reference/array/functions/array-chunk.xml:1.6 phpdoc-ro/reference/array/functions/array-chunk.xml:1.7 --- phpdoc-ro/reference/array/functions/array-chunk.xml:1.6 Tue Sep 18 13:38:22 2007 +++ phpdoc-ro/reference/array/functions/array-chunk.xml Fri Jun 6 06:56:20 2008 @@ -1,47 +1,97 @@ -<?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.0 Maintainer: adiju Status: outdated --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_chunk</refname> - <refpurpose>Împarte un tablou în mai multe tablouri</refpurpose> - </refnamediv> - <refsect1> - <title>Descriere</title> - <methodsynopsis> - <type>array</type><methodname>array_chunk</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam> - </methodsynopsis> - <para> - <function>array_chunk</function> împarte un tablou în - mai multe tablouri, fiecare având cel mult <parameter>size</parameter> valori. - Unul dintre tablourile returnate poate avea mai puþine valori - la sfîrºit. Tablourile rezultate vor face parte dintr-un - tablou multidimensional cu index numeric care începe - de la zero. - </para> - <para> - Prin setarea parametrului opþional <parameter>preserve_keys</parameter> - ca &true;, PHP poate fi forþat sã pãstreze indecºii originali - din tabloul iniþial. Dacã se specificã &false; în fiecare tablou - rezultat vor fi utilizaþi indecºi numerici noi - pornind de la zero. Valoarea implicitã este &false;. - </para> - <example> - <title>Exempul de utilizare <function>array_chunk</function></title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: simionea Status: translated --> +<!-- CREDITS: adiju --> +<refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_chunk</refname> + <refpurpose>Desparte un tablou în porÅ£iuni</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>array_chunk</methodname> + <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam> + </methodsynopsis> + <para> + Desparte un tablou în porÅ£iuni de dimensiunea <parameter>size</parameter>. + Ultima porÅ£iune poate sÄ conÅ£inÄ mai puÅ£ine elemente decât + <parameter>size</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + + <varlistentry> + <term><parameter>input</parameter></term> + <listitem> + <para> + Tabloul cu care se lucreazÄ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>size</parameter></term> + <listitem> + <para> + Dimensiunea fiecÄrei porÅ£iuni + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>preserve_keys</parameter></term> + <listitem> + <para> + Când este stabilit în &true; cheile vor fi pÄstrate. + Implicit sete &false;, ceea ce va reindexa numeric porÅ£iunea + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ãntoarce un tablou multidimensional indexat numeric, începând cu zero, + fiecare dimensiune conÅ£inând <parameter>size</parameter> elemente. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + DacÄ <parameter>size</parameter> este mai mic decât 1 va fi emisÄ o eroare + <constant>E_WARNING</constant> Åi se va întoarce &null;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemplu <function>array_chunk</function></title> + <programlisting role="php"> <![CDATA[ +<?php $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); -print_r(array_chunk($input_array, 2, TRUE)); +print_r(array_chunk($input_array, 2, true)); +?> ]]> - </programlisting> - <para> - Rezultatul va fi: - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -84,11 +134,11 @@ ) ]]> - </screen> - </para> - </example> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-ro/reference/array/functions/array-diff.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ro/reference/array/functions/array-diff.xml diff -u phpdoc-ro/reference/array/functions/array-diff.xml:1.5 phpdoc-ro/reference/array/functions/array-diff.xml:1.6 --- phpdoc-ro/reference/array/functions/array-diff.xml:1.5 Tue Sep 18 13:38:22 2007 +++ phpdoc-ro/reference/array/functions/array-diff.xml Fri Jun 6 06:56:20 2008 @@ -1,62 +1,137 @@ -<?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.0 Maintainer: adiju Status: outdated --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> - <refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_diff</refname> - <refpurpose>Calculeazã diferenþa tablourilor</refpurpose> - </refnamediv> - <refsect1> - <title>Descriere</title> - <methodsynopsis> - <type>array</type><methodname>array_diff</methodname> - <methodparam><type>array</type><parameter>array1</parameter></methodparam> - <methodparam><type>array</type><parameter>array2</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> - </methodsynopsis> - <para> - <function>array_diff</function> returneazã un tablou - ce conþine toate valorile din <parameter>array1</parameter> - care nu sunt prezente în celelalte argumente. - Indecºii sunt pãstraþi. - </para> - <para> - <example> - <title>Exemplu de utilizare <function>array_diff</function></title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.16 Maintainer: simionea Status: translated --> +<!-- CREDITS: adiju --> +<refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_diff</refname> + <refpurpose>CalculeazÄ diferenÅ£a dintre tablouri</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>array_diff</methodname> + <methodparam><type>array</type><parameter>array1</parameter></methodparam> + <methodparam><type>array</type><parameter>array2</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> + </methodsynopsis> + <para> + ComparÄ <parameter>array1</parameter> cu <parameter>array2</parameter> Åi + întoarce diferenÅ£a. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array1</parameter></term> + <listitem> + <para> + Tabloul de referinÅ£Ä + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>array2</parameter></term> + <listitem> + <para> + Tabloul care se comparÄ + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + Mai multe tablouri pentru a se compara + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ãntoarce un <type>array</type> ce conÅ£ine toate înregistrÄrile din + <parameter>array1</parameter> care nu sunt prezente nici în unul din + celelalte tablouri. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemplu <function>array_diff</function></title> + <programlisting role="php"> <![CDATA[ -$array1 = array ("a" => "green", "red", "blue", "red"); -$array2 = array ("b" => "green", "yellow", "red"); -$result = array_diff ($array1, $array2); +<?php +$array1 = array("a" => "green", "red", "blue", "red"); +$array2 = array("b" => "green", "yellow", "red"); +$result = array_diff($array1, $array2); + +print_r($result); +?> ]]> - </programlisting> - </example> - </para> - <para> - Variabila <varname>$result</varname> va conþine - <literal>array ("blue");</literal>. Mai multe apariþii ale aceleaºi valori în - $array1 sunt tratate în acelaºi fel. - </para> - <note> - <simpara> - Douã elemente sunt considerate egale dacã ºi numai dacã - <literal>(string) $elem1 === (string) $elem2</literal>. Cu alte cuvinte: - atunci când reprezentãrile ca ºiruri a celor douã valori sunt identice. - <!-- TODO: example of it... --> - </simpara> - </note> - <warning> - <simpara> - Aceastã funcþie nu a funcþionat în PHP 4.0.4! - <!-- TODO: when exactly was this broken?... --> - </simpara> - </warning> + </programlisting> <para> - Vezi de asemenea ºi <function>array_intersect</function>. + ApariÅ£iile multiple în $array1 sunt toate tratate în acelaÅi mod. + Aceasta va afiÅa : </para> - </refsect1> - </refentry> + <screen> +<![CDATA[ +Array +( + [1] => blue +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + DouÄ elemente sunt considerate egale dacÄ Åi numai dacÄ <literal>(string) + $elem1 === (string) $elem2</literal>. Ãn cuvinte: dacÄ reprezentarea lor + ca Åiruri de caractere este aceeaÅi. + <!-- TODO: example of it... --> + </para> + </note> + <note> + <para> + AceastÄ funcÅ£ie verificÄ numai o dimensiune a unui tablou n-dimensional. + Desigur cÄ puteÅ£i sÄ verificaÅ£i dimensiunile mai adânci utilizând + <literal>array_diff($array1[0], $array2[0]);</literal>. + </para> + </note> + <warning> + <simpara> + Aceasta era greÅit în PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>array_diff_assoc</function></member> + <member><function>array_intersect</function></member> + <member><function>array_intersect_assoc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: