Share via


Array 형식 확장

업데이트: 2007년 11월

정적 메서드를 추가하여 기본 ECMAScript(JavaScript) Array 기능에 확장을 제공합니다.

네임스페이스: 없음. 이 형식 확장은 전역적이며 네임스페이스의 일부가 아닙니다.

상속: Array

var arrayVar = new Array("Saturn","Mars","Jupiter");
Array.add(arrayVar, "Earth");

멤버 확장

이름

설명

Array.add 함수

Array 개체의 끝에 요소를 추가합니다.

Array.addRange 함수

지정된 배열의 모든 요소를 Array 개체의 끝에 복사합니다.

Array.clear 함수

Array 개체의 모든 요소를 제거합니다.

Array.clone 함수

Array 개체의 단순 복사본을 만듭니다.

Array.contains 함수

요소가 Array 개체에 포함되어 있는지 여부를 확인합니다.

Array.dequeue 함수

Array 개체에서 첫 번째 요소를 제거합니다.

Array.enqueue 함수

Array 개체의 끝에 요소를 추가합니다.

참고

Array.enqueue 함수 대신 add 함수를 사용하십시오.

Array.forEach 함수

Array 개체의 각 요소에 대해 지정된 작업을 수행합니다.

Array.indexOf 함수

Array 개체의 지정된 요소를 검색하여 인덱스를 반환합니다.

Array.insert 함수

Array 개체에서 지정된 위치에 값을 삽입합니다.

Array.parse 함수

문자열 표현을 변환하여 Array 개체를 만듭니다.

Array.remove 함수

Array 개체에서 요소의 첫 번째 인스턴스를 제거합니다.

Array.removeAt 함수

Array 개체에서 지정된 위치에 있는 요소를 제거합니다.

설명

Array 확장은 Microsoft AJAX 라이브러리의 일부입니다. 이 확장은 추가 기능을 제공하기 위해 JavaScript Array 개체에 정적 메서드를 추가합니다.

이러한 정적 메서드에서 확장하는 JavaScript 개체 및 관련 생성자에 대한 자세한 내용은 언어 참조Array 개체를 참조하십시오.

예제

다음 예제에서는 새 Array 개체를 만들고 Microsoft AJAX 라이브러리의 add 함수를 호출하여 배열을 요소 형태로 단일 배열에 추가하는 방법을 보여 줍니다. 그런 다음에는 배열을 문서에 테이블 형태로 표시하는 함수에 다차원 배열이 전달됩니다.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Sample</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager runat="server" ID="ScriptManager1">
        </asp:ScriptManager>

        <div id="results">
        </div>

        <script type="text/javascript">

        // Create and display a table based on array content.
        function displayTable(arrayTable, element) 
        {
            var tableMarkup;
            tableMarkup = "<table border=on>";
            var rows = arrayTable[0][0].length;

            for(x=0; x<=rows; x++)
            {
               tableMarkup += "<tr>";
               var columns = arrayTable[x].length - 1;
               for(y=0; y<=columns; y++)
               {
                    tableMarkup += "<td>" + arrayTable[x][y] + "</td>";
               }
               tableMarkup += "</tr>";
            }
            tableMarkup += "</table>";

            element.innerHTML += tableMarkup;

            // Clean up.
            Array.clear(arrayTable);
        }

        // Create table data.
        function createTableData() 
        {
               var costsArray = [];

               var headerRow = new Array("ID", "Name", "Costs");
               var firstRow = new Array("1", "ruler", "1.30");
               var secondRow = new Array("2", "binder", "4.75");

               Array.add(costsArray, headerRow);
               Array.add(costsArray, firstRow);
               Array.add(costsArray, secondRow);

               return costsArray;
        }  

        var myTable = createTableData();
        var element = $get("results");
        displayTable(myTable, element);

    </script>
    </form>
</body>
</html>


참고 항목

참조

Array 개체

new 연산자

배열 형식 함수