std::max

헤더 `<algorithm>`
template< class T > const T& max( const T& a, const T& b );	에 정의됨 (1)	(C++14부터 constexpr)
template< class T, class Compare > const T& max( const T& a, const T& b, Compare comp );	(2)	(C++14부터 constexpr)
template< class T > T max( std::initializer_list<T> ilist );	(3)	(C++11부터) (C++14부터 constexpr)
template< class T, class Compare > T max( std::initializer_list<T> ilist, Compare comp );	(4)	(C++11부터) (C++14부터 constexpr)

주어진 값들 중 더 큰 값을 반환합니다.

1,2) a와 b 중 더 큰 값을 반환합니다.

1) 값을 비교하는 데 operator<을 사용합니다.

T이 LessThanComparable이 아닌 경우 동작은 정의되지 않습니다.

2) 값을 비교하는 데 비교 함수 comp을 사용합니다.

3,4) 초기화 리스트 ilist의 값들 중 가장 큰 값을 반환합니다.

ilist.size()이 0이거나 T이 CopyConstructible이 아닌 경우 동작은 정의되지 않습니다.

3) 값을 비교하는 데 operator<을 사용합니다.

T이 LessThanComparable이 아닌 경우 동작은 정의되지 않습니다.

4) 값을 비교하는 데 비교 함수 comp을 사용합니다.

매개변수

a, b - 비교할 값들

ilist - 비교할 값들을 가진 초기화자 리스트

comp

-

비교 함수 객체(즉, Compare 요구 사항을 만족하는 객체)로 a 가 b 보다 작은 경우 true 를 반환합니다.

비교 함수의 시그니처는 다음에 해당해야 합니다:

bool cmp ( const Type1 & a, const Type2 & b ) ;

시그니처에 const & 가 필요하지는 않지만, 함수는 전달된 객체를 수정해서는 안 되며 값 범주 에 관계없이 (가능한 const) Type1 및 Type2 타입의 모든 값을 수용할 수 있어야 합니다 (따라서 Type1 & 는 허용되지 않으며 , Type1 도 Type1 에 대해 이동이 복사와 동등하지 않는 한 허용되지 않습니다 (C++11부터) ).
Type1 및 Type2 타입은 T 타입의 객체가 두 타입 모두로 암시적으로 변환될 수 있어야 합니다.

반환값

1,2) a 와 b 중 더 큰 값. 두 값이 동등할 경우 a 를 반환합니다.

3,4) ilist 에서 가장 큰 값. 여러 값이 최대값과 동일한 경우 가장 왼쪽 값을 반환합니다.

복잡도

1) 정확히 한 번의 비교를 operator < 를 사용하여 수행합니다.

2) 비교 함수의 정확히 한 번의 적용 comp .

3,4) 주어진

N

이 ilist. size ( ) 인 경우:

3) 정확히

N-1

번의 비교를 operator < 를 사용하여 수행합니다.

4) 정확히

N-1

번의 비교 함수 comp 적용.

가능한 구현

최대값 (1)
template<class T> const T& max(const T& a, const T& b) { return (a < b) ? b : a; }
최대값 (2)
template<class T, class Compare> const T& max(const T& a, const T& b, Compare comp) { return (comp(a, b)) ? b : a; }
최대값 (3)
template<class T> T max(std::initializer_list<T> ilist) { return *std::max_element(ilist.begin(), ilist.end()); }
최대값 (4)
template<class T, class Compare> T max(std::initializer_list<T> ilist, Compare comp) { return *std::max_element(ilist.begin(), ilist.end(), comp); }

참고 사항

std::max 의 결과를 참조로 캡처할 때, 매개변수 중 하나가 임시 객체이고 해당 매개변수가 반환되면 댕글링 참조가 발생합니다:

int n = -1;
const int& r = std::max(n + 2, n * 2); // r은 댕글링 참조입니다

예제

이 코드 실행

#include <algorithm>
#include <iomanip>
#include <iostream>
#include <string_view>
int main()
{
    auto longest = [](const std::string_view s1, const std::string_view s2)
                   {
                       return s1.size() < s2.size();
                   };
    std::cout << "Larger of 69 and 96 is " << std::max(69, 96) << "\n"
                 "Larger of 'q' and 'p' is '" << std::max('q', 'p') << "'\n"
                 "Largest of 010, 10, 0X10, and 0B10 is "
              << std::max({010, 10, 0X10, 0B10}) << '\n'
              << R"(Longest of "long", "short", and "int" is )"
              << std::quoted(std::max({"long", "short", "int"}, longest)) << '\n';
}

출력:

Larger of 69 and 96 is 96
Larger of 'q' and 'p' is 'q'
Largest of 010, 10, 0X10, and 0B10 is 16
Longest of "long", "short", and "int" is "short"

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR	적용 대상	게시된 동작	올바른 동작
LWG 281	C++98	`T` 가 CopyConstructible 요구사항을 만족해야 했음 ( 1,2 ) 오버로드에 대해	요구사항이 아님
LWG 2239	C++98 C++11	1. `T` 가 LessThanComparable 요구사항을 만족해야 했음 ( 2 ) (C++98) 및 ( 4 ) (C++11) 오버로드에 대해 2. 복잡도 요구사항이 누락됨	1. 요구사항이 아님 2. 요구사항 추가됨

참고 항목

min	주어진 값 중 더 작은 값을 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
ranges::min (C++20)	주어진 값 중 더 작은 값을 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
minmax (C++11)	두 요소 중 더 작은 값과 더 큰 값을 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
ranges::minmax (C++20)	두 요소 중 더 작은 값과 더 큰 값을 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
max_element	범위 내에서 가장 큰 요소를 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
ranges::max_element (C++20)	범위 내에서 가장 큰 요소를 반환합니다 (함수 템플릿 & 알고리즘 함수 객체)
clamp (C++17)	값을 경계값 쌍 사이에 고정합니다 (함수 템플릿 & 알고리즘 함수 객체)
ranges::clamp (C++20)	값을 경계값 쌍 사이에 고정합니다 (함수 템플릿 & 알고리즘 함수 객체)
ranges::max (C++20)	주어진 값 중 더 큰 값을 반환합니다 (알고리즘 함수 객체)

컴파일러 지원
프리스탠딩 및 호스티드
언어
표준 라이브러리
표준 라이브러리 헤더
명명된 요구사항
기능 테스트 매크로 (C++20)
언어 지원 라이브러리
개념 라이브러리 (C++20)
진단 라이브러리
메모리 관리 라이브러리
메타프로그래밍 라이브러리 (C++11)
일반 유틸리티 라이브러리
컨테이너 라이브러리
반복자 라이브러리
범위 라이브러리 (C++20)
알고리즘 라이브러리
문자열 라이브러리
텍스트 처리 라이브러리
수치 라이브러리
날짜 및 시간 라이브러리
입출력 라이브러리
파일 시스템 라이브러리 (C++17)
동시성 지원 라이브러리 (C++11)
실행 제어 라이브러리 (C++26)
기술 명세서
기호 인덱스
외부 라이브러리

ko.cppreference.net

Namespaces

Variants