allocator_base 클래스
동기화 필터에서 사용자 정의 할당자를 만드는 데 필요한 기본 클래스 및 일반 함수를 정의합니다.
구문
template <class Type, class Sync>
class allocator_base
매개 변수
Type
할당자에 의해 할당된 요소 형식입니다.
동기화
할당자에 대한 동기화 정책, 즉 sync_none 클래스, sync_per_container 클래스, sync_per_thread 클래스 또는 sync_shared 클래스입니다.
생성자
| 생성자 | Description |
|---|---|
| allocator_base | allocator_base 형식의 개체를 생성합니다. |
Typedef
| 형식 이름 | 설명 |
|---|---|
| const_pointer | 할당자에 의해 관리되는 개체 형식에 대한 상수 포인터를 제공하는 형식입니다. |
| const_reference | 할당자에 의해 관리되는 개체 형식에 대한 상수 참조를 제공하는 형식입니다. |
| difference_type | 할당자에 의해 관리되는 개체 형식에 대한 포인터 값의 차이를 나타낼 수 있는 부호 있는 정수 형식입니다. |
| pointer | 할당자에 의해 관리되는 개체 형식에 대한 포인터를 제공하는 형식입니다. |
| reference | 할당자에 의해 관리되는 개체 형식에 대한 참조를 제공하는 형식입니다. |
| size_type | 형식 개체가 할당할 수 있는 시퀀스의 길이를 나타낼 수 있는 부호 없는 정수 계열 형식 allocator_base 입니다. |
| value_type | 할당자에 의해 관리되는 형식입니다. |
멤버 함수
| 멤버 함수 | 설명 |
|---|---|
| _Charalloc | char 형식의 배열에 대한 스토리지를 할당합니다. |
| _Chardealloc | char 형식의 요소를 포함하는 배열에 대한 스토리지를 해제합니다. |
| address | 값이 지정된 개체의 주소를 찾습니다. |
| allocate | 적어도 지정된 개수의 요소를 저장할 수 있을 만큼 큰 메모리 블록을 할당합니다. |
| construct | 지정된 값으로 초기화된 특정 형식의 개체를 지정된 주소에 생성합니다. |
| deallocate | 지정된 위치부터 시작하여 스토리지에서 지정된 개수의 개체를 해제합니다. |
| destroy | 개체가 저장된 메모리 할당을 취소하지 않고 개체 소멸자를 호출합니다. |
| max_size | 사용 가능한 메모리가 모두 사용되기 전에 allocator 클래스의 개체가 할당할 수 있는 Type 형식의 요소 수를 반환합니다. |
요구 사항
헤더:<할당자>
네임스페이스: stdext
allocator_base::_Charalloc
char 형식의 배열에 대한 스토리지를 할당합니다.
char *_Charalloc(size_type count);
매개 변수
count
할당할 배열의 요소 수입니다.
Return Value
할당된 개체에 대한 포인터입니다.
설명
이 멤버 함수는 다시 바인딩을 컴파일할 수 없는 컴파일러로 컴파일할 때 컨테이너에서 사용됩니다. 동기화 필터의 allocate 함수에 대한 호출 결과를 반환하여 사용자 정의 할당자에 대해 _Charalloc를 구현합니다.
allocator_base::_Chardealloc
char 형식의 요소를 포함하는 배열에 대한 스토리지를 해제합니다.
void _Chardealloc(void* ptr, size_type count);
매개 변수
ptr
스토리지에서 할당을 취소할 첫 번째 개체에 대한 포인터입니다.
count
스토리지에서 할당을 취소할 개체의 수입니다.
설명
이 멤버 함수는 다시 바인딩을 컴파일할 수 없는 컴파일러로 컴파일할 때 컨테이너에서 사용됩니다. 동기화 필터의 deallocate 함수를 호출하여 사용자 정의 할당자에 대해 _Chardealloc를 구현합니다. *this와 같은지를 비교하여 같은 크기와 형식의 배열 개체를 할당하는 할당자 개체에 대해 _Charalloc를 호출함으로써 포인터 ptr이 이미 반환된 상태여야 합니다. _Chardealloc은 예외를 throw할 수 없습니다.
allocator_base::address
값이 지정된 개체의 주소를 찾습니다.
pointer address(reference val);
const_pointer address(const_reference val);
매개 변수
val
주소를 검색하는 개체의 const 또는 nonconst 값입니다.
Return Value
각각 const 또는 nonconst 값으로 발견된 개체에 대한 const 또는 nonconst 포인터입니다.
설명
이 멤버 함수는 &val을 반환함으로써 사용자 정의 할당자에 대해 구현됩니다.
allocator_base::allocate
적어도 지정된 개수의 요소를 저장할 수 있을 만큼 큰 메모리 블록을 할당합니다.
template <class Other>
pointer allocate(size_type _Nx, const Other* _Hint = 0);
pointer allocate(size_type _Nx);
매개 변수
_Nx
할당할 배열의 요소 수입니다.
_Hint
이 매개 변수는 무시됩니다.
Return Value
할당된 개체에 대한 포인터입니다.
설명
_Nx == 1인 경우 멤버 함수는 Type * 형식의 동기화 필터의 allocate 함수에 대한 호출 결과를 반환하여 사용자 정의 할당자에 대한 메모리 할당을 구현합니다. 아닌 경우 호출 결과를 operator new(_Nx * sizeof(Type))으로 반환하여 Type * 형식으로 캐스팅합니다.
allocator_base::allocator_base
allocator_base 형식의 개체를 생성합니다.
allocator_base();
template <class Other>
allocator_base(const allocator_base<Other, Sync>& right);
매개 변수
right
복사할 할당자 개체입니다.
설명
첫 번째 생성자는 allocator_base 인스턴스를 생성합니다. 두 번째 생성자는 임의의 allocator_base<Type, _Sync> 인스턴스 a, allocator_base<Type, Sync>(allocator_base<Other, Sync>(a)) == a에 대해 allocator_base 인스턴스를 생성합니다.
allocator_base::const_pointer
할당자에 의해 관리되는 개체 형식에 대한 상수 포인터를 제공하는 형식입니다.
typedef const Type *const_pointer;
allocator_base::const_reference
할당자에 의해 관리되는 개체 형식에 대한 상수 참조를 제공하는 형식입니다.
typedef const Type& const_reference;
allocator_base::construct
지정된 값으로 초기화된 특정 형식의 개체를 지정된 주소에 생성합니다.
void construct(pointer ptr, const Type& val);
매개 변수
ptr
개체를 생성할 위치에 대한 포인터입니다.
val
생성되는 개체를 초기화할 값입니다.
설명
이 멤버 함수는 new((void*)ptr Type(val)을 호출함으로써 사용자 정의 할당자에 대해 구현됩니다.
allocator_base::d올로세이트
지정된 위치부터 시작하여 스토리지에서 지정된 개수의 개체를 해제합니다.
void deallocate(pointer ptr, size_type _Nx);
매개 변수
ptr
스토리지에서 할당을 취소할 첫 번째 개체에 대한 포인터입니다.
_Nx
스토리지에서 할당을 취소할 개체의 수입니다.
설명
이 멤버 함수는 _Nx == 1인 경우 동기화 필터 Sync에서 deallocate(ptr)를 호출하고, 아닌 경우 operator delete(_Nx * ptr)를 호출함으로써 사용자 정의 할당자에 대해 구현됩니다.
allocator_base::d estroy
개체가 저장된 메모리 할당을 취소하지 않고 개체 소멸자를 호출합니다.
void destroy(pointer ptr);
매개 변수
ptr
소멸될 개체의 주소를 지정하는 포인터입니다.
설명
이 멤버 함수는 ptr->~Type()을 호출함으로써 사용자 정의 할당자에 대해 구현됩니다.
allocator_base::d ifference_type
할당자에 의해 관리되는 개체 형식에 대한 포인터 값의 차이를 나타낼 수 있는 부호 있는 정수 형식입니다.
typedef std::ptrdiff_t difference_type;
allocator_base::max_size
사용 가능한 메모리가 모두 사용되기 전에 allocator 클래스의 개체가 할당할 수 있는 Type 형식의 요소 수를 반환합니다.
size_type max_size() const;
Return Value
할당할 수 있는 요소의 수입니다.
설명
이 멤버 함수는 0 < (size_t)-1 / sizeof(Type)인 경우 (size_t)-1 / sizeof(Type), 아닌 경우 1을 반환함으로써 사용자 정의 할당자에 대해 구현됩니다.
allocator_base::p오인터
할당자에 의해 관리되는 개체 형식에 대한 포인터를 제공하는 형식입니다.
typedef Type *pointer;
allocator_base::reference
할당자에 의해 관리되는 개체 형식에 대한 참조를 제공하는 형식입니다.
typedef Type& reference;
allocator_base::size_type
형식 개체가 할당할 수 있는 시퀀스의 길이를 나타낼 수 있는 부호 없는 정수 계열 형식 allocator_base 입니다.
typedef std::size_t size_type;
allocator_base::value_type
할당자에 의해 관리되는 형식입니다.
typedef Type value_type;