# getRowsByDup (method)

> 열 내에 중복된 데이터를 가진 데이터 로우 객체들을 리턴합니다.
> 여러 개의 열이름을 설정 시 열이름에 해당하는 열들의 셀 값이 모두 같은 경우에만 데이터 로우 객체를 반환합니다.

### Syntax

    object getRowsByDup( cols, firstOnly, emptyVal, subsum, exceptStatus );

### Parameters

Name | Type | Required | Description
--- | --- | --- | ---
cols | `string` | 필수 | 비교할 대상이 되는 열이름 ","를 구분자로 사용하여 복수 개의 열이름들을 지정 가능
firstOnly | `boolean` | 선택 | 처음으로 중복된 행을 반환할지 여부 설정 시 가장 먼저 중복된 행을 리턴합니다(원래 값을 가지는 데이터 로우 객체, 중복된 데이터 로우 객체로 이루어진 배열). `0(false)`:처음으로 중복된 행 반환 사용 안함 (`default`) `1(true)`:처음으로 중복된 행 반환 사용
emptyVal | `boolean` | 선택 | "", undefined, null 값을 가지는 행을 비교 대상에 포함할지 여부 `0(false)`:중복된 값 비교 대상에 "", undefined, null 값을 가진 행을 포함 안함 (`default`) `1(true)`:중복된 값 비교 대상에 "", undefined, null 값을 가진 행을 포함
subsum | `boolean` | 선택 | 중복된 값 비교할 때 소계행을 사용할 지 여부 `0(false)`:중복된 값 비교대상에 소계행 포함 안함 (`default`) `1(true)`:중복된 값 비교대상에 소계행 포함
exceptStatus | `string` | 선택 | 비교대상에서 제외할 행의 상태 ","를 구분자로 사용하여 복수 개의 상태값들을 지정 가능

### Return Value

array[row object] : 중복된 값을 가지는 데이터 로우 객체들의 배열의 배열(각기 다른 중복된 값 마다 생성된 데이터 로우 객체들의 배열)

### Example

    // sName, sSalary의 열이 서로 같은 값을 가지는 데이터 로우 객체들의 배열의 배열을 리턴합니다.
    // ex) [ [r1, r2...] [r5, r9...] ]
    // r1과 r2는 sName, sSalary의 값이 같습니다. r5과 r9..는 sName, sSalary의 값이 같습니다.
    // Added, Deleted 상태의 로우 객체는 제외하여 리턴합니다.
    sheet.getRowsByDup( "sName,sSalary" , false, false, false, "Added,Deleted" );

### Read More

### Since

product | version | desc
--- | --- | ---
core | 8.0.0.0 | 기능 추가
core | 8.0.0.8 | exceptStatus 기능 추가