영어로 읽기

다음을 통해 공유


함수 나열

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

정보

이름 묘사
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 시작부터 크기 개수의 시간 값 목록을 반환합니다.

매개 변수 값

발생 사양

정렬 순서

수식 조건

목록 값에 대한 수식 조건을 다음 중 하나로 지정할 수 있습니다.

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

자세한 내용과 예제를 보려면 List.Distinct로 가십시오.

비교 조건

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

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

자세한 내용과 예제를 보려면 List.Sort로 이동하세요.

대체 작업

대체 작업은 목록 값으로 지정됩니다. 이 목록의 각 항목은 다음과 여야 합니다.

  • 정확히 두 항목의 목록 값입니다.
  • 첫 번째 항목은 바꿀 목록의 이전 값입니다.
  • 두 번째 항목은 목록에서 이전 값의 모든 항목을 대체해야 하는 새 값입니다.