アプリケーションの記述

{doc type = method, 
    public {StringInterface.equal?
               str:StringInterface,
               ignore-case?:bool=false
           }:bool
    {purpose
        Checks whether {ctext self} is equal to a specified
        {docref StringInterface}. 
    }
    {parameter str,
        The {docref StringInterface} with which you want to check
        for equality. 
    }
    {parameter ignore-case?,
        A keyword argument that indicates whether the test is to  
        ignore the case of the characters.  By default, the 
        test does not ignore case ({ctext ignore-case?=false}).  
        In other words, by default the test is case sensitive.  
        For example, {ctext "abcdefg"} is not equal to 
        {ctext "ABCDEFG"}.
    
        {param ignore-case?} is a keyword argument.  To specify  
        {param ignore-case?}, make sure to assign the desired  
        value to the keyword in the method call (for example 
        {ctext ignore-case?=true}).

        If you specify {ctext ignore-case?} and assign it 
        to {ctext true}, the test is not case-sensitive. 
        In this situation, {ctext "abcdefg"} is equal to 
        {ctext "ABCDEFG"}.
    }
    {return-vals
        A {ctext bool} value.  Returns {ctext true} if each 
        character in {ctext self} is equal to the corresponding 
        character in {param str}.  Otherwise, returns 
        {ctext false}.
    }
    {for-example
        . . . 
    }
}

{doc
    type = package,
    CURL.GRAPHICS.SCENE
    {purpose
        This package provides an interface for 3D
        retained-mode graphics. 
    }
    {details
        . . . 
    }
}

{doc-next
    {unadvertised}
}

{doc mystify
    {unadvertised}
}

{doc-next
    {purpose
        Parameterized class for one-dimensional arrays.
    }
    {parameter t,
        The data type of the elements in the array.
    }
    {details
        There are a number of collection types built into
        the Curl language, including:
        {itemize
            {item Arrays}
            {item Hash tables}
            {item Sets}
            {item Strings}
            {item Arguments}
        }
        {ctext Array-of} allows you to create one dimensional
        arrays that can increase in size.  The ordered
        collection classes that are built into the Curl
        language, like {ctext Array-of}, inherit from {docref
        Sequence-of}.  The elements in such collections are
        indexed by a contiguous set of integers, starting at
        0.
    }
    {notes
        A partial hierarchy of the collection classes in the
        Curl language follows:

        {docref Aggregate-of}
        {br} {Fill width = 0.25in} {indent-symbol} {docref Association-of}
        {br} {Fill width = 0.5in} {indent-symbol} {docref HashTable-of}
        {br} {Fill width = 0.5in} {indent-symbol} {docref Sequence-of}
        {br} {Fill width = 0.75in} {indent-symbol} {ctext Array-of}
        {br} {Fill width = 0.25in} {indent-symbol} {docref Array-2-of}
        {br} {Fill width = 0.25in} {indent-symbol} {docref Set-of}
        {br}{docref FastArray-of}{br}

        For more information about collections, see the
        Developer's Guide chapter on {link href = {dguide-url
        "collections.curl"}, Collections}.
    }
}

{doc-next
    {purpose
        Returns an {docref Iterator-of} containing each
        element of the array.
    }
    {return-vals
        An {ctext Iterator-of} with the same parameterized
        data type as the elements in {ctext self}.  In other
        words, if {ctext self} is an {ctext {Array-2-of int}},
        this method returns an {ctext {Iterator-of int}}.
    }
    {details
        This method preserves the order of the elements (using 
        the order of the internal representation).  The
        elements are stored for each index in the first
        dimension in turn.  When storing the elements for an
        index in the first dimension, the compiler stores the
        elements for each index in the second dimension in
        turn.  For example, the elements of a {ctext 2 x 3}
        array are stored as follows: 

        {ctext (0,0), (0,1), (0,2), (1,0), (1,1), (1,2)}

    }
    {for-example
        Here is an example that uses an iterator to display
        the elements in a simple 2D array of strings: 
        {example
            title = {text Displaying an {ctext Array-2-of
                                            String}}, 
            {value
                || String の2次元配列を作成します。
                let my-array:{Array-2-of String} =
                    {new {Array-2-of String}, 2, 3}

                || 要素を配列に入れます。
                set my-array[0, 0] = "Harry"
                set my-array[1, 0] = "Sally"
                set my-array[0, 1] = "Tom"
                set my-array[1, 1] = "Mary"
                set my-array[0, 2] = "John"
                set my-array[1, 2] = "Anne"

                || Iterator-of を上記の set から作成します。
                let my-iterator:{Iterator-of String} =
                    {my-array.to-Iterator}

                || VBox を使用して my-iterator のコンテンツを表示します。
                || my-iterator のコンテンツを VBox に加える反復処理を行い、
                || VBoxで表示します。
                let message:VBox = {VBox}
                {for each-element:String in my-iterator do
                    {message.add each-element}
                }
                message
            }
        }
    }
    {notes
        Alternatively, you can use a {docref for} container loop
        to achieve the same results.  Where possible, you should
        use a {ctext for} loop in case this iteration mechanism
        is overridden, producing unexpected results.
    }
}