함수 나열
이러한 함수는 목록 값을 만들고 조작합니다.
이름 | 묘사 |
---|---|
List.Count | 목록의 항목 수를 반환합니다. |
List.NonNullCount | null 값을 제외한 목록의 항목 수를 반환합니다. |
List.IsEmpty | 목록이 비어 있는지 여부를 반환합니다. |
이름 | 묘사 |
---|---|
List.Alternate | 개수, 선택적 반복 간격 및 선택적 오프셋을 기준으로 원래 목록의 항목을 순차적으로 나열한 목록을 반환합니다. |
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 예외를 발생시킵니다. |
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를 반환합니다. |
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을 포함할 수도 있습니다. null은 항상 비교 시 가장 작은 값으로 취급됩니다. 그렇지 않으면 Expression.Error
throw됩니다.
비교 가능한 데이터 형식은 다음과 같습니다.
- 수
- 기간
- 날짜시간
- 문자 메시지
- 논리적인
- 널
이름 | 묘사 |
---|---|
List.Max | 목록의 최대 항목을 반환하거나 목록이 비어 있는 경우 선택적 기본값을 반환합니다. |
List.MaxN | 목록의 최대값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정해야 합니다. |
List.Median | 목록에서 중앙값 항목을 반환합니다. |
List.Min | 목록의 최소 항목을 반환하거나 목록이 비어 있는 경우 선택적 기본값을 반환합니다. |
List.MinN | 목록의 최소값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정할 수 있습니다. |
List.Sort | 비교 조건을 사용하여 정렬된 목록을 반환합니다. |
List.Percentile | 지정된 확률에 해당하는 하나 이상의 샘플 백분위수 값을 반환합니다. |
이러한 함수는 숫자, 날짜/시간 및 기간의 동질적인 목록에 대해 작동합니다.
이름 | 묘사 |
---|---|
List.Average | 리스트의 값의 데이터 형식에 따라 평균값을 반환합니다. |
List.Mode | 목록에 가장 일반적으로 나타나는 항목을 반환합니다. |
List.Modes | 동일한 최대 빈도로 표시되는 모든 항목을 반환합니다. |
List.StandardDeviation | 값 목록에서 표준 편차를 반환합니다. List.StandardDeviation 샘플 기반 예상치를 수행합니다. 결과는 숫자의 경우 숫자이며, DateTime과 Duration의 경우 기간입니다. |
이러한 함수는 같은 유형의 숫자 또는 기간 목록에 대해 작동합니다.
이름 | 묘사 |
---|---|
List.Sum | 목록에서 합계를 반환합니다. |
이러한 함수는 숫자에 대해서만 작동합니다.
이름 | 묘사 |
---|---|
List.Covariance | 두 목록의 공변도를 숫자로 반환합니다. |
List.Product | 숫자 목록에서 제품을 반환합니다. |
이러한 함수는 값 목록을 생성합니다.
이름 | 설명 |
---|---|
List.Dates | 시작부터 시작하여 크기 수에서 날짜 값 목록을 반환하고 모든 값에 증분을 추가합니다. |
List.DateTimes | 시작부터 시작하여 크기 수에서 날짜/시간 값 목록을 반환하고 모든 값에 증분을 추가합니다. |
List.DateTimeZones | 시작부터 시작하여 크기 수에서 datetimezone 값 목록을 반환하고 모든 값에 증분을 추가합니다. |
List.Durations | 시작부터 시작하여 크기 수에서 기간 값 목록을 반환하고 모든 값에 증분을 추가합니다. |
List.Generate | 값 목록을 생성합니다. |
List.Numbers | 초기값부터 주어진 개수의 숫자 목록을 반환하며, 증분을 추가합니다. 증분은 기본적으로 1로 설정됩니다. |
List.Random | 선택적 시드 매개 변수를 사용하여 개수 난수 목록을 반환합니다. |
List.Times | 시작부터 크기 개수의 시간 값 목록을 반환합니다. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- 정렬_내림차순 = 1;
목록 값에 대한 수식 조건을 다음 중 하나로 지정할 수 있습니다.
- 다음 중 하나인 함수 값입니다.
- 같음 조건을 적용할 목록의 값을 결정하는 키 선택기입니다.
- 적용할 비교 종류를 지정하는 데 사용되는 비교자 함수입니다. 기본 제공 비교자 함수를 지정할 수 있습니다. 비교자 함수로 이동하십시오.
- 다음이 포함된 목록 값입니다.
- 정확히 두 개의 항목입니다.
- 첫 번째 요소는 위에서 지정한 키 선택기입니다.
- 두 번째 요소는 위에서 지정한 비교자입니다.
자세한 내용과 예제를 보려면 List.Distinct로 가십시오.
비교 조건은 다음 값 중 하나로 제공할 수 있습니다.
- 정렬 순서를 지정할 숫자 값입니다. 자세한 정보는 정렬 순서을 참조하십시오.
- 정렬에 사용할 키를 계산하기 위해 하나의 인수 함수를 사용할 수 있습니다.
- 키와 컨트롤 순서를 모두 선택하려면 비교 기준이 키와 순서를 포함하는 목록일 수 있습니다.
- 비교를 완전히 제어하기 위해 왼쪽 및 오른쪽 입력 간의 관계를 고려할 때 -1, 0 또는 1을 반환하는 두 인수의 함수를 사용할 수 있습니다. Value.Compare 이 논리를 위임하는 데 사용할 수 있는 메서드입니다.
자세한 내용과 예제를 보려면 List.Sort로 이동하세요.
대체 작업은 목록 값으로 지정됩니다. 이 목록의 각 항목은 다음과 여야 합니다.
- 정확히 두 항목의 목록 값입니다.
- 첫 번째 항목은 바꿀 목록의 이전 값입니다.
- 두 번째 항목은 목록에서 이전 값의 모든 항목을 대체해야 하는 새 값입니다.