getRowsByDup (method)

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

Syntax

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

Parameters

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