목록 함수

아티클
08/28/2023

이러한 함수는 목록 값을 만들고 조작합니다.

정보

이름	설명
List.Count	목록의 항목 수를 반환합니다.
List.NonNullCount	null 값을 제외한 목록의 항목 수를 반환합니다.
List.IsEmpty	목록이 비어 있는지 여부를 반환합니다.

선택 사항

이름	설명
List.Alternate	개수, 선택적 repeatInterval 및 선택적 오프셋을 기준으로 원래 목록에서 대체된 항목이 있는 목록을 반환합니다.
List.Buffer	메모리의 목록을 버퍼링합니다. 이 호출의 결과는 안정적인 목록입니다. 즉, 결정적 개수와 항목 순서가 포함됩니다.
List.Distinct	중복 항목을 제거하여 목록을 필터링합니다. 같음 비교를 제어하기 위해 선택적 수식 조건 값을 지정할 수 있습니다. 각 같음 그룹의 첫 번째 값이 선택됩니다.
List.FindText	레코드 필드를 비롯한 값 목록을 검색하여 텍스트 값을 검색합니다.
List.First	목록의 첫 번째 값 또는 지정한 기본값(비어 있는 경우)을 반환합니다. 목록이 비어 있는 경우 목록의 첫 번째 항목 또는 선택적 기본값을 반환합니다. 목록이 비어 있고 기본값을 지정하지 않으면 함수가 반환됩니다.
List.FirstN	반환할 항목 수 또는 제공 `countOrCondition`된 한정 조건을 지정하여 목록의 첫 번째 항목 집합을 반환합니다.
List.InsertRange	입력 목록의 지정된 인덱스에 있는 값의 항목을 삽입합니다.
List.IsDistinct	목록이 고유한지 여부를 반환합니다.
List.Last	반환할 항목 수 또는 다음에서 제공하는 `countOrCondition`한정 조건을 지정하여 목록의 마지막 항목 집합을 반환합니다.
List.LastN	반환할 항목 수 또는 한정 조건을 지정하여 목록의 마지막 항목 집합을 반환합니다.
List.MatchesAll	목록의 모든 항목이 조건을 충족하는 경우 true를 반환합니다.
List.MatchesAny	목록의 항목이 조건을 충족하는 경우 true를 반환합니다.
List.Positions	입력 목록의 위치 목록을 반환합니다.
List.Range	오프셋에서 시작하는 개수 항목을 반환합니다.
List.Select	조건과 일치하는 항목을 선택합니다.
List.Single	목록의 단일 항목을 반환하거나, 목록의 항목이 둘 이상이면 `Expression.Error`를 throw합니다.
List.SingleOrDefault	목록에서 단일 항목을 반환합니다.
List.Skip	목록의 첫 번째 항목을 건너뜁니다. 빈 목록을 지정하면 빈 목록이 반환됩니다. 이 함수는 선택적 매개 변수 `countOrCondition`을 사용하여 여러 값을 건너뛸 수 있도록 지원합니다.

변환 함수

이름	설명
List.Accumulate	목록에서 결과를 누적합니다. 초기 값 시드부터 이 함수는 누적기 함수를 적용하고 최종 결과를 반환합니다.
List.Combine	목록 목록을 단일 목록으로 병합합니다.
List.ConformToPageReader	이 함수는 내부용으로만 사용됩니다.
List.RemoveRange	오프셋에서 시작하는 개수 항목을 제거하는 목록을 반환합니다. 기본 개수는 1입니다.
List.RemoveFirstN	첫 번째 요소에서 시작하여 목록에서 제거된 요소의 수를 지정한 목록을 반환합니다. 제거되는 요소 수는 선택적 `countOrCondition` 매개 변수에 따라 달라집니다.
List.RemoveItems	`list2`에 있는 `list1`에서 항목을 제거하고 새 목록을 반환합니다.
List.RemoveLastN	마지막 요소에서 시작하여 목록에서 제거된 요소의 수를 지정한 목록을 반환합니다. 제거되는 요소 수는 선택적 `countOrCondition` 매개 변수에 따라 달라집니다.
List.Repeat	입력 목록 개수 횟수의 내용을 반복하는 목록을 반환합니다.
List.ReplaceRange	목록의 개수 값을 인덱스에서 시작하는 `replaceWith` 목록으로 바꾸는 목록을 반환합니다.
List.RemoveMatchingItems	목록에서 지정된 값의 모든 항목을 제거합니다.
List.RemoveNulls	목록에서 null 값을 제거합니다.
List.ReplaceMatchingItems	제공된 `equationCriteria`를 사용하여 목록에서 기존 값의 항목을 새 값으로 바꿉니다. 이전 값과 새 값은 `replacements` 매개 변수가 제공합니다. 같음 비교를 제어하기 위해 선택적 수식 조건 값을 지정할 수 있습니다. 바꾸기 작업 및 수식 조건에 대한 자세한 내용을 보려면 매개 변수 값을 참조하세요.
List.ReplaceValue	값 목록을 검색하여 각 항목을 대체 값으로 바꿉니다.
List.Reverse	목록의 항목을 반대로 하는 목록을 반환합니다.
List.Split	지정된 페이지 크기를 사용하여 지정된 목록을 목록 목록으로 분할합니다.
List.Transform	목록의 각 항목에 대해 함수를 수행하고 새 목록을 반환합니다.
List.TransformMany	입력 목록에서 요소가 프로젝션되는 목록을 반환합니다.

멤버 자격 함수

모든 값이 같은지 테스트할 수 있으므로 이러한 함수는 다른 유형의 목록에 대해 작동할 수 있습니다.

이름	설명
List.AllTrue	목록의 모든 식이 true이면 true를 반환합니다.
List.AnyTrue	true 목록의 식이 있으면 true를 반환합니다.
List.Contains	목록에 값이 있으면 true를 반환합니다.
List.ContainsAll	값의 모든 항목이 목록에 있으면 true를 반환합니다.
List.ContainsAny	값의 항목이 목록에 있으면 true를 반환합니다.
List.PositionOf	목록에서 값의 첫 번째 항목을 찾아 해당 위치를 반환합니다.
List.PositionOfAny	값에서 값의 첫 번째 항목을 찾아 해당 위치를 반환합니다.

작업 설정

이름	설명
List.Difference	목록 2에 표시되지 않는 목록 1의 항목을 반환합니다. 중복 값이 지원됩니다.
List.Intersect	목록 목록에서 목록을 반환하고 개별 목록의 공통 항목을 교차합니다. 중복 값이 지원됩니다.
List.Union	목록 목록에서 목록을 반환하고 개별 목록의 항목을 통합합니다. 반환된 목록에는 입력 목록의 모든 항목이 포함됩니다. 중복 값은 Union의 일부로 일치합니다.
List.Zip	동일한 위치에 있는 항목을 결합하는 목록 목록을 반환합니다.

주문

순서 지정 함수는 비교를 수행합니다. 비교되는 모든 값은 서로 비교되어야 합니다. 즉, 모두 동일한 데이터 형식에서 온 것이어야 합니다(또는 항상 가장 작은 데이터 형식을 비교하는 null 포함). 그렇지 않으면 Expression.Error이 throw됩니다.

비교 가능한 데이터 형식은 다음과 같습니다.

숫자
기간
DateTime
Text
논리
Null

이름	설명
List.Max	목록의 최대 항목을 반환하거나 목록이 비어 있는 경우 선택적 기본값을 반환합니다.
List.MaxN	목록의 최대값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정해야 합니다.
List.Median	목록에서 중앙값 항목을 반환합니다.
List.Min	목록의 최소 항목을 반환하거나 목록이 비어 있는 경우 선택적 기본값을 반환합니다.
List.MinN	목록의 최소값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정할 수 있습니다.
List.Sort	비교 조건을 사용하여 정렬된 목록을 반환합니다.
List.Percentile	지정된 확률에 해당하는 하나 이상의 샘플 백분위수 값을 반환합니다.

평균

이러한 함수는 숫자, 날짜/시간 및 기간의 동질적인 목록에 대해 작동합니다.

이름	설명
List.Average	목록의 데이터 형식에 있는 목록의 평균 값을 반환합니다.
List.Mode	목록에 가장 일반적으로 나타나는 항목을 반환합니다.
List.Modes	동일한 최대 빈도로 표시되는 모든 항목을 반환합니다.
List.StandardDeviation	값 목록에서 표준 편차를 반환합니다. List.StandardDeviation은 샘플 기반 예측을 수행합니다. 결과는 숫자의 숫자와 DateTimes 및 Durations의 기간입니다.

더하기

이러한 함수는 같은 유형의 숫자 또는 기간 목록에 대해 작동합니다.

이름	설명
List.Sum	목록에서 합계를 반환합니다.

숫자

이러한 함수는 숫자에 대해서만 작동합니다.

이름	설명
List.Covariance	두 목록의 공변도를 숫자로 반환합니다.
List.Product	숫자 목록에서 제품을 반환합니다.

생성기

이러한 함수는 값 목록을 생성합니다.

이름	설명
List.Dates	시작부터 시작하여 크기 수에서 날짜 값 목록을 반환하고 모든 값에 증분을 추가합니다.
List.DateTimes	시작부터 시작하여 크기 수에서 날짜/시간 값 목록을 반환하고 모든 값에 증분을 추가합니다.
List.DateTimeZones	시작부터 시작하여 크기 수에서 datetimezone 값 목록을 반환하고 모든 값에 증분을 추가합니다.
List.Durations	시작부터 시작하여 크기 수에서 기간 값 목록을 반환하고 모든 값에 증분을 추가합니다.
List.Generate	값 목록을 생성합니다.
List.Numbers	초기부터 크기 개수의 숫자 목록을 반환하고 증분을 추가합니다. 증분은 기본적으로 1로 설정됩니다.
List.Random	선택적 시드 매개 변수를 사용하여 개수 난수 목록을 반환합니다.
List.Times	시작부터 크기 개수의 시간 값 목록을 반환합니다.

매개 변수 값

발생 사양

정렬 순서

Order.Ascending = 0;
Order.Descending = 1;

수식 조건

목록 값의 수식 조건을 다음으로 지정할 수 있습니다.

다음 중 하나인 함수 값입니다.
- 같음 조건을 적용할 목록에서 값을 결정하는 키 선택기 또는
- 적용할 비교 종류를 지정하는 데 사용되는 비교자 함수입니다. 기본 제공 비교자 함수를 지정할 수 있습니다. 비교자 함수에 대한 섹션을 참조하세요.
다음이 포함된 목록 값입니다.
- 정확히 두 개 항목입니다.
- 첫 번째 요소는 위에 지정된 키 선택기입니다.
- 두 번째 요소는 위에서 지정한 비교자입니다.

자세한 내용 및 예제는 List.Distinct를 참조하세요.

비교 조건

비교 조건은 다음 값 중 하나로 제공할 수 있습니다.

정렬 순서를 지정할 숫자 값입니다. 자세한 내용을 보려면정렬 순서를 참조하세요.
정렬에 사용할 키를 계산하기 위해 인수 1개의 함수를 사용할 수 있습니다.
키와 컨트롤 순서를 모두 선택하려면 비교 기준이 키와 순서를 포함하는 목록일 수 있습니다.
비교를 완전히 제어하기 위해 왼쪽 입력과 오른쪽 입력 간의 관계를 고려하여 -1, 0 또는 1을 반환하는 인수 2 개의 함수를 사용할 수 있습니다. Value.Compare는 이 논리를 대리하는 데 사용할 수 있는 메서드입니다.

자세한 내용 및 예제는 List.Sort를 참조하세요.

대체 작업

대체 작업은 목록 값이 지정합니다. 이 목록의 각 항목은 다음과 같아야 합니다.

정확히 두 개 항목의 목록 값입니다.
첫 번째 항목은 목록에서 대체될 이전 값입니다.
두 번째 항목은 목록에 있는 이전 값의 모든 항목을 대체하는 새 값입니다.

다음을 통해 공유