Update cell help page. 94/17094/3
Charlotte HECQUET [Mon, 24 Aug 2015 09:56:06 +0000 (11:56 +0200)]
Change-Id: I216658c37b85b5c9b47e544ed51898cc6ba46725

scilab/modules/data_structures/help/en_US/cell.xml
scilab/modules/data_structures/help/ja_JP/cell.xml
scilab/modules/data_structures/help/pt_BR/cell.xml
scilab/modules/data_structures/help/ru_RU/cell.xml

index 120dc17..5f19583 100644 (file)
             <code>cell()</code> is equivalent to <code>cell(0)</code>.
         </para>
         <para>
-            If <literal>A</literal> is a cell array, you can access the contents of an element of <literal>A</literal> by using <code>A(m1, m2, ..., mn).entries</code>. The expression <code>A(1,1) = zeros(2,2)</code> is not valid, the right syntax is
-            <code>A(1,1).entries = zeros(2,2)</code>.
-        </para>
-        <para>
-            If <literal>A</literal> is a cell array, you can get its dimensions by using <code>A.dims</code> which returns an <literal>int32</literal> value that cannot be used as a subscript for the cell array. In this case, the best way to get the cell array dimensions is <code>size(A)</code>.
+            If <literal>A</literal> is a cell array, you can access the contents of an element of <literal>A</literal> by using <code>A{m1, m2, ..., mn}</code>. The expression <code>A(1,1) = zeros(2,2)</code> is not valid, the right syntax is
+            <code>A{1,1} = zeros(2,2)</code>.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
-a=cell(3)
-b=cell(3,1)
-c=cell([2,3,4])
+a = cell(3)
+b = cell(3,1)
+c = cell([2,3,4])
  
 // Assigning cell entries
-b=cell(3,1);
+b = cell(3,1);
  
-// Assigning the first element of b using the 'entries' field
-b(1).entries=1:3
+// Assigning the first element of b using {}
+b{1} = 1:3
  
-// Assigning the second element of b using the 'entries' field
-b(2).entries='Scilab'
+// Assigning the second element of b using {}
+b{2} = 'Scilab'
  
 // Assigning the third element of b using the 'entries' field
-b(3).entries=poly(1:3,'s')
+b{3} = poly(1:3,'s')
  
 // Assigning sub-cells
-X=cell(3,2);
-X(:,1)=b
+X = cell(3,2);
+X{:,1} = b
  
 // Extracting a sub-cell: result is a cell
-b(1)
-b(1:2)
+b{1}
+b{1:2}
  
 // Extracting a sub-cell value: result is an array
-b(1).entries
+b{1}
  
-// Dimensions of b as an int32 value (cannot be used as an index)
-b.dims
 // Dimensions of b as a double value
 size(b)
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -159,6 +153,22 @@ size(b)
             <member>
                 <link linkend="zeros">zeros</link>
             </member>
+            <member>
+                <link linkend="iscell">iscell</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Fields "entries" and "dims" do not exist anymore. To assign or extract an element, use {}.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index b5926fd..be7e034 100644 (file)
             <literal>cell(0)</literal>に等しくなりです.
         </para>
         <para>A がセル配列の場合, 
-            <literal>A(m1, m2, ..., mn).entries</literal>により
+            <literal>A{m1, m2, ..., mn}</literal>により
             Aの要素の内容にアクセスすることができます.
             式 <literal>A(1,1) = zeros(2,2)</literal> は有効ではなく,
-            <literal>A(1,1).entries = zeros(2,2)</literal>が正しい構文となります.
-        </para>
-        <para>A がセル配列の場合, 
-            <literal>A.dims</literal>によりその次元を得ることができます.
+            <literal>A{1,1} = zeros(2,2)</literal>が正しい構文となります.
         </para>
     </refsection>
     <refsection>
         <title>例</title>
         <programlisting role="example"><![CDATA[ 
-a=cell(3)
-b=cell(3,1)
-c=cell([2,3,4])
+a = cell(3)
+b = cell(3,1)
+c = cell([2,3,4])
 // Assigning cell entries
-b=cell(3,1);
-// Assigning the first element of b using the 'entries' field
-b(1).entries=1:3
-// Assigning the second element of b using the 'entries' field
-b(2).entries='Scilab'
+b = cell(3,1);
+// Assigning the first element of b using {}
+b{1} = 1:3
+// Assigning the second element of b using {}
+b{2} = 'Scilab'
 // Assigning the third element of b using the 'entries' field
-b(3).entries=poly(1:3,'s')
+b{3} = poly(1:3,'s')
 // Assigning sub-cells
-X=cell(3,2);
-X(:,1)=b
+X = cell(3,2);
+X{:,1} = b
 // Extracting a sub-cell: result is a cell
-b(1)
-b(1:2)
+b{1}
+b{1:2}
 // Extracting a sub-cell value: result is an array
-b(1).entries
-// Dimensions of b
-b.dims
+b{1}
+// Dimensions of b as a double value
+size(b)
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -148,6 +153,22 @@ b.dims
             <member>
                 <link linkend="zeros">zeros</link>
             </member>
+            <member>
+                <link linkend="iscell">iscell</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Fields "entries" and "dims" do not exist anymore. To assign or extract an element, use {}.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 41d1dab..47e92e2 100644 (file)
             <literal>cell(0)</literal>.
         </para>
         <para>Se A for um cell, você pode acessar os conteúdos de um elemento de A
-            utilizando <literal>A(m1, m2, ..., mn).entries</literal>. A expressão
+            utilizando <literal>A{m1, m2, ..., mn}</literal>. A expressão
             <literal>A(1,1) = zeros(2,2)</literal> não é válida, a sintaxe correta é
-            <literal>A(1,1).entries = zeros(2,2)</literal>.
-        </para>
-        <para>Se A é um cell, você pode obter suas dimensões através de
-            <literal>A.dims</literal>.
+            <literal>A{1,1} = zeros(2,2)</literal>.
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
         <programlisting role="example"><![CDATA[ 
-a=cell(3)
-b=cell(3,1)
-c=cell([2,3,4])
-
-// atribuição em entradas do cell
-b=cell(3,1);
-
-// atribuindo o primeiro elemento de b utilizando o campo 'entries'
-b(1).entries=1:3
-
-// atribuindo o segundo elemento de b utilizando o campo 'entries'
-b(2).entries='Scilab'
-
-// atribuindo o terceiro elemento de b utilizando o campo 'entries'
-b(3).entries=poly(1:3,'s')
-
-// atribuição de sub-cells
-X=cell(3,2);
-X(:,1)=b
-
-// extraindo um sub-cell: o resultado é um cell
-b(1)
-b(1:2)
-
-// extraindo o valor de um sub-cell: o resultado é um array
-b(1).entries
-
-// dimensões de b
-b.dims
+a = cell(3)
+b = cell(3,1)
+c = cell([2,3,4])
+// Assigning cell entries
+b = cell(3,1);
+// Assigning the first element of b using {}
+b{1} = 1:3
+// Assigning the second element of b using {}
+b{2} = 'Scilab'
+// Assigning the third element of b using the 'entries' field
+b{3} = poly(1:3,'s')
+// Assigning sub-cells
+X = cell(3,2);
+X{:,1} = b
+// Extracting a sub-cell: result is a cell
+b{1}
+b{1:2}
+// Extracting a sub-cell value: result is an array
+b{1}
+// Dimensions of b as a double value
+size(b)
  ]]></programlisting>
     </refsection>
     <refsection>
@@ -159,6 +156,22 @@ b.dims
             <member>
                 <link linkend="zeros">zeros</link>
             </member>
+            <member>
+                <link linkend="iscell">iscell</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Fields "entries" and "dims" do not exist anymore. To assign or extract an element, use {}.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 21b35a2..f8ef81f 100644 (file)
         <para>
             Если <literal>A</literal> является cell-массивом, то у вас есть
             допуск к содержимому элемента <literal>A</literal> с помощью
-            <code>A(m1, m2, ..., mn).entries</code>. Инструкция
+            <code>A{m1, m2, ..., mn}</code>. Инструкция
             <code>A(1,1) = zeros(2,2)</code> не допустима, правильным
-            синтаксисом является <code>A(1,1).entries = zeros(2,2)</code>.
-        </para>
-        <para>
-            Если <literal>A</literal> является cell-массивом, то вы можете получить его размеры с помощью <code>A.dims</code>, которое возвращает значение типа <literal>int32</literal> и которое нельзя использовать в качестве индекса в cell-массиве. В этом случае лучше всего использовать <code>size(A)</code>.
+            синтаксисом является <code>A{1,1} = zeros(2,2)</code>.
         </para>
     </refsection>
     <refsection>
         <title>Примеры</title>
         <programlisting role="example"><![CDATA[
-a=cell(3)
-b=cell(3,1)
-c=cell([2,3,4])
-
-// Определение cell-элементов
-b=cell(3,1);
-
-// Присвоение значения первому элементу b с помощью поля 'entries'
-b(1).entries=1:3
-
-// Присвоение значения второму элементу b с помощью поля 'entries'
-b(2).entries='Scilab'
-
-// Присвоение значения третьему элементу b с помощью поля 'entries'
-b(3).entries=poly(1:3,'s')
-
-// Присвоение cell-подмассивов
-X=cell(3,2);
-X(:,1)=b
-
-// Выделение cell-подмассива: результатом является cell-массив
-b(1)
-b(1:2)
-
-// Выделение значения cell-подмассива: результатом является массив
-b(1).entries
-
-// Размеры b в виде значения int32 (нельзя использовать в качестве индекса)
-b.dims
-// Размеры b в виде значения double
+a = cell(3)
+b = cell(3,1)
+c = cell([2,3,4])
+// Assigning cell entries
+b = cell(3,1);
+// Assigning the first element of b using {}
+b{1} = 1:3
+// Assigning the second element of b using {}
+b{2} = 'Scilab'
+// Assigning the third element of b using the 'entries' field
+b{3} = poly(1:3,'s')
+// Assigning sub-cells
+X = cell(3,2);
+X{:,1} = b
+// Extracting a sub-cell: result is a cell
+b{1}
+b{1:2}
+// Extracting a sub-cell value: result is an array
+b{1}
+// Dimensions of b as a double value
 size(b)
-
 ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -163,7 +157,23 @@ size(b)
             <member>
                 <link linkend="zeros">zeros</link>
             </member>
+            <member>
+                <link linkend="iscell">iscell</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Fields "entries" and "dims" do not exist anymore. To assign or extract an element, use {}.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>