new[] 演算子 (CRT)
更新 : 2007 年 11 月
ヒープからメモリ ブロックを割り当てます。
void *__cdecl operator new[](
size_t count
);
void *__cdecl operator new[] (
size_t count,
void * object
) throw();
void *__cdecl operator new[] (
size_t count,
const std::nothrow_t&
) throw();
パラメータ
count
メモリ割り当てのサイズ。object
オブジェクトが作成されるメモリ ブロックへのポインタ。
戻り値
新たに割り当てられるストレージの最下位バイト アドレスへのポインタ。
解説
この形式の operator new は、スカラ型の new (operator new) に対して、ベクタ型の new と呼ばれます。
この演算子の 1 番目の形式は、仮引数なしの形式と呼ばれます。第 2 の形式は仮引数付き、第 3 の形式は例外をスローしない、仮引数付きと呼ばれます。
この演算子の 1 番目の形式はコンパイラによって定義され、プログラムに new.h をインクルードする必要がありません。
operator delete[] は operator new によって割り当てられたメモリを解放します。
割り当てに失敗したときに operator new[] が null を返すか、例外をスローするかを設定できます。詳細については、「The new and delete Operators」を参照してください。
CRT の operator new の動作は、スローの動作を除き、標準 C++ ライブラリの operator new[] と同じです。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
new[] |
<new.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
ベクタ型で仮引数なしの operator new の使用方法を次に示します。
// crt_new4.cpp
#include <stdio.h>
int main() {
int * k = new int[10];
k[0] = 21;
printf("%d\n", k[0]);
delete [] k;
}
ベクタ型で仮引数付きの operator new の使用方法を次に示します。
// crt_new5.cpp
#include <stdio.h>
#include <new.h>
int main() {
int * i = new int[10];
i[0] = 21;
printf("%d\n", i[0]);
// initialize existing memory (i) with, in this case, int[[10]
int * j = new(i) int[10]; // placement vector new
printf("%d\n", j[0]);
j[0] = 22;
printf("%d\n", i[0]);
delete [] i; // or, could have deleted [] j
}
ベクタ型で例外をスローしない、仮引数付きの operator new の使用方法を次に示します。
// crt_new6.cpp
#include <stdio.h>
#include <new.h>
int main() {
int * k = new(std::nothrow) int[10];
k[0] = 21;
printf("%d\n", k[0]);
delete [] k;
}