다음을 통해 공유

함수 나열

  • 아티클

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

정보

이름 묘사
List.Count 목록의 항목 수를 반환합니다.
List.IsEmpty 목록이 비어 있으면 true 반환합니다.
List.NonNullCount 목록에 null이 아닌 항목의 수를 반환합니다.

선택

이름 묘사
List.Alternate 목록의 모든 홀수 오프셋 요소로 구성된 목록을 반환합니다.
List.Buffer 목록을 버퍼링합니다.
List.Distinct 중복 항목이 제거된 값 목록을 반환합니다.
List.FindText 지정한 텍스트가 포함된 값 목록(레코드 필드 포함)을 반환합니다.
List.First 목록의 첫 번째 값 또는 지정한 기본값(비어 있는 경우)을 반환합니다.
List.FirstN 반환할 항목 수 또는 한정 조건을 지정하여 목록의 첫 번째 항목 집합을 반환합니다.
List.InsertRange 지정된 인덱스의 목록에 값을 삽입합니다.
List.IsDistinct 목록에 중복이 있는지 여부를 나타냅니다.
List.Last 목록의 마지막 값 또는 지정한 기본값(비어 있는 경우)을 반환합니다.
List.LastN 목록의 마지막 값을 반환합니다. 필요에 따라 반환할 값 수 또는 한정 조건을 지정할 수 있습니다.
List.MatchesAll 조건 함수가 목록의 모든 값에 만족하는 경우 true 반환합니다.
List.MatchesAny 조건 함수가 모든 값에 의해 충족되는 경우 true 반환합니다.
List.Positions 입력에 대한 오프셋 목록을 반환합니다.
List.Range 오프셋에서 시작하는 목록의 하위 집합을 반환합니다.
List.Select 조건과 일치하는 값 목록을 반환합니다.
List.Single 길이가 1인 목록에서는 하나의 목록 항목을 반환하고, 그렇지 않으면 예외를 발생시킵니다.
List.SingleOrDefault 길이가 1인 목록의 목록 항목 하나와 빈 목록의 기본값을 반환합니다.
List.Skip 목록의 시작 부분에 있는 지정된 개수의 요소를 건너뛰는 목록을 반환합니다.

변환 함수

이름 묘사
List.Accumulate 목록의 항목에서 요약 값을 누적합니다.
List.Combine 여러 목록을 결합하여 단일 목록을 반환합니다.
List.ConformToPageReader 이 함수는 내부용으로만 사용됩니다.
List.RemoveFirstN 목록의 시작 부분에 있는 지정된 개수의 요소를 건너뛰는 목록을 반환합니다.
List.RemoveItems 두 번째 목록에 있는 첫 번째 목록에서 항목을 제거합니다.
List.RemoveLastN 목록의 끝에서 지정된 개수의 요소를 제거하는 목록을 반환합니다.
List.RemoveMatchingItems 입력 값의 모든 생성 빈도를 제거합니다.
List.RemoveNulls 지정된 목록에서 모든 null 값을 제거합니다.
List.RemoveRange 지정된 위치에서 시작하는 값의 개수를 제거합니다.
List.Repeat 원래 목록을 count번 반복한 목록을 반환합니다.
List.ReplaceMatchingItems 목록에 있는 기존 값의 발생을 조건과 일치하는 새 값으로 바꿉니다.
List.ReplaceRange position에서 시작하는 count개의 값을 대체 값으로 교체합니다.
List.ReplaceValue 목록을 검색하여 지정된 값을 바꿉니다.
List.Reverse 목록의 값 순서를 반대로 바뀝니다.
List.Split 지정된 페이지 크기를 사용하여 지정된 목록을 목록 목록으로 분할합니다.
List.Transform 이 목록에서 계산된 값의 새 목록을 반환합니다.
List.TransformMany 지정된 함수를 사용하여 입력 목록에서 요소가 변환되는 목록을 반환합니다.
List.Zip 여러 목록에서 동일한 위치에 있는 항목을 결합하여 목록 목록을 반환합니다.

멤버 자격 함수

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

이름 묘사
List.AllTrue 모든 식이 true이면 true 반환합니다.
List.AnyTrue 하나의 식이라도 true이면 true를 반환합니다.
List.Contains 목록에 값이 포함되어 있는지 여부를 나타냅니다.
List.ContainsAll 목록에 다른 목록의 모든 값이 포함된 위치를 나타냅니다.
List.ContainsAny 목록에 다른 목록의 값이 포함된 위치를 나타냅니다.
List.PositionOf 목록에 있는 값의 오프셋을 반환합니다.
List.PositionOfAny 목록에서 값의 첫 번째 오프셋을 반환합니다.

작업 설정

이름 묘사
List.Difference 지정된 두 목록의 차이를 반환합니다.
List.Intersect 입력에 있는 목록 값의 교집합을 반환합니다.
List.Union 입력에 있는 목록 값의 합치를 반환합니다.

주문

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

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

  • 수
  • 기간
  • 날짜시간
  • 문자 메시지
  • 논리적인
  • 널
이름 묘사
List.Max 빈 목록의 최대값 또는 기본값을 반환합니다.
List.MaxN 목록에서 최대값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정해야 합니다.
List.Median 목록의 중앙값을 반환합니다.
List.Min 빈 목록의 최소값 또는 기본값을 반환합니다.
List.MinN 목록에서 최소값을 반환합니다. 반환할 값의 수 또는 필터링 조건을 지정할 수 있습니다.
List.Sort 지정된 조건에 따라 데이터 목록을 정렬합니다.
List.Percentile 지정된 확률에 해당하는 하나 이상의 샘플 백분위수 값을 반환합니다.

평균

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

이름 묘사
List.Average 값의 평균을 반환합니다. 숫자, 날짜, 날짜/시간, datetimezone 및 기간 값으로 작동합니다.
List.Mode 목록에서 가장 빈번한 값을 반환합니다.
List.Modes 목록에서 가장 자주 사용하는 값 목록을 반환합니다.
List.StandardDeviation 표준 편차의 샘플 기반 예상치를 반환합니다. 이 함수는 샘플 기반 예상을 수행합니다. 결과는 숫자의 경우 숫자이며, DateTime과 Duration의 경우 기간입니다.

덧셈

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

이름 묘사
List.Sum 목록에 있는 항목의 합계를 반환합니다.

숫자

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

이름 묘사
List.Covariance 두 숫자 목록 간의 공변성 값을 반환합니다.
List.Product 목록에 있는 숫자의 곱을 반환합니다.

발전기

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

이름 묘사
List.Dates 초기 값, 개수 및 증분 기간 값이 지정된 date 값 목록을 생성합니다.
List.DateTimes 초기 값, 개수 및 증분 기간 값이 지정된 datetime 값 목록을 생성합니다.
List.DateTimeZones 초기 값, 개수 및 증분 기간 값이 지정된 datetimezone 값 목록을 생성합니다.
List.Durations 초기 값, 개수 및 증분 기간 값이 지정된 duration 값 목록을 생성합니다.
List.Generate 값 목록을 생성합니다.
List.Numbers 초기 값, 개수 및 선택적 증분 값이 지정된 숫자 목록을 반환합니다.
List.Random 난수 목록을 반환합니다.
List.Times 초기 값, 개수 및 증분 기간 값이 지정된 time 값 목록을 생성합니다.

매개 변수 값

발생 사양

정렬 순서

수식 조건

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

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

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

비교 조건

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

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

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

대체 작업

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

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