path: root/modules/string/help/ja_JP/strtod.xml

<?xml version="1.0" encoding="UTF-8"?>

<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - 
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 *
 -->

<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="strtod" xml:lang="ja">
    
    <refnamediv>
        
        <refname>strtod</refname>
        
        <refpurpose>文字列を倍精度実数に変換.</refpurpose>
        
    </refnamediv>
    
    <refsynopsisdiv>
        
        <title>呼び出し手順</title>
        
        <synopsis>
            
            d =  strtod(str [,decimalseparator])
            
            [d, endstr] = strtod(str [,decimalseparator])
            
        </synopsis>
        
    </refsynopsisdiv>
    
    <refsection>
        
        <title>引数</title>
        
        <variablelist>
            
            <varlistentry>
                
                <term>str</term>
                
                <listitem>
                    
                    <para>
                        
                        文字列または文字列の行列
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>decimalseparator</term>
                
                <listitem>
                    
                    <para>
                        
                        選択した10進数セパレータ: "." (デフォルト) または ",".
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>d</term>
                
                <listitem>
                    
                    <para>
                        
                        実数または実数の行列
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>endstr</term>
                
                <listitem>
                    
                    <para>
                        
                        文字列または文字列の行列 
                        
                        (<varname>str</varname>の中で数値の後に続く文字).
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
        </variablelist>
        
    </refsection>
    
    <refsection>
        
        <title>説明</title>
        
        <para>
            
            <code>[d, endstr] = strtod(str)</code> は,
            
            文字列<varname>str</varname> を
            
            パースし,その内容を浮動小数点数として解釈して,
            
            その値を実数として返します.
            
            <varname>str</varname>に数値が含まれていない場合,
            
            <varname>d</varname> は <literal>Nan</literal>となります.
            
        </para>
        
    </refsection>
    
    <refsection>
        
        <title>注意</title>
        
        <itemizedlist>
            
            <listitem>
                
                <para>
                    
                    この関数はWindowsとLinuxで動作が異なるstrtod C関数に基づきます.
                    
                    実際, Windows では指数部にd または D を使用できますが,
                    
                    16進数を使用することはできません.
                    
                </para>
                
            </listitem>
            
            <listitem>
                
                <para>
                    
                    <literal>strtod("%inf")</literal> は <literal>Nan</literal>を
                    
                    返すことに注意してください.
                    
                </para>
                
            </listitem>
            
        </itemizedlist>
        
    </refsection>
    
    
    
    <refsection>
        
        <title>例</title>
        
        <programlisting role="example"><![CDATA[
strtod('123.556This is a sample real')
strtod('123,556This is a sample real', ",")
[d,endstr] = strtod('123.556This is a sample real')
strtod(['123.556This is a sample real','888.666 here'])
[d,endstr] =strtod(['123.556This is a sample real','888.666 here'])
[d,endstr] =strtod(['123.556This is a sample real','888,666 here'], ",")
 ]]></programlisting>
        
    </refsection>
    
    <refsection>
        
        <title>履歴</title>
        
        <revhistory>
            
            <revision>
                
                <revnumber>5.5.0</revnumber>
                
                <revremark>
                    
                    新しいオプション入力: decimalseparator (SEP 97).
                    
                </revremark>
                
            </revision>
            
            <revision>
                
                <revnumber>5.4.1</revnumber>
                
                <revremark>
                    
                    <varname>str</varname> に数値が含まれていない場合,
                    
                    <varname>d</varname> は以前のバージョンのように
                    
                    <literal>0</literal>ではなく,
                    
                    <literal>Nan</literal>となります.
                    
                </revremark>
                
            </revision>
            
        </revhistory>
        
    </refsection>
    
</refentry>