std::atomic_ref<T>:: fetch_add

T 가 cv bool 이 아닌 산술 타입이거나 객체 포인터 타입인 경우에만 제공됨
value_type fetch_add ( difference_type arg, std:: memory_order order = std:: memory_order_seq_cst ) const noexcept ;		(C++26부터 constexpr)

* ptr 가 참조하는 현재 값을, 해당 값과 arg 의 산술 덧셈 결과로 원자적으로 교체합니다. 이 연산은 읽기-수정-쓰기 연산입니다. 메모리는 order 값에 따라 영향을 받습니다.

• 부호 있는 정수형의 경우, 산술 연산은 2의 보수 표현을 사용하도록 정의됩니다. 정의되지 않은 결과는 없습니다.
• 부동소수점 타입의 경우, floating-point environment 이 호출 스레드의 floating-point environment와 다를 수 있습니다. 연산이 해당 std::numeric_limits 특성에 따를 필요는 없지만 따르는 것이 권장됩니다. 결과가 해당 타입으로 표현 가능한 값이 아닌 경우, 결과는 지정되지 않지만 그 외에는 정의되지 않은 동작이 없습니다.
• 포인터 타입의 경우, 결과가 정의되지 않은 주소일 수 있지만 그 외에는 정의되지 않은 동작이 없습니다.
  • 만약 std:: remove_pointer_t < T > 가 완전한 객체 타입이 아닌 경우, 프로그램은 ill-formed입니다.

이 오버로드는 std:: is_const_v < T > 가 false 인 경우에만 오버로드 해결에 참여합니다.

목차 1 매개변수 2 반환 값 3 예제 4 결함 보고서

매개변수

arg	-	산술 덧셈의 다른 인자
order	-	적용할 메모리 순서 제약 조건

반환값

이 함수의 효과가 발생하기 직전에 * ptr 이 참조하는 값.

예제

이 섹션은 불완전합니다 이유: 예시가 없음

결함 보고서

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

DR	적용 대상	게시된 동작	올바른 동작
LWG 3508 ( P3323R1 )	C++20	fetch_add 는 const T 에 대해 무의미했음	비-const T 만 허용하도록 제한됨