Library Reference

version 2.112.0

Internal API

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page.Requires a signed-in GitHub account. This works well for small changes.If you'd like to make larger changes you may want to consider usinga local clone.

core.internal.array.capacity

This module contains support for controlling dynamic arrays' capacity and length

License:

Distributed under theBoost Software License 1.0. (See accompanying file LICENSE)

Sourcecore/internal/array/capacity.d

@trusted void_d_arrayshrinkfit(Tarr : T[], T)(Tarrarr, boolisshared);

Shrink the "allocated" length of an array to be the exact size of the array.

It doesn't matter what the current allocated length of the array is, theuser is telling the runtime that he knows what he is doing.

Parameters:

T	the type of the elements in the array (this should be unqualified)
Tarr`arr`	array to shrink. Its.length is element length, not byte length, despitevoid type
bool`isshared`	true if the underlying data is shared

pure nothrow @trusted size_t_d_arraysetcapacityPureNothrow(T)(size_tnewcapacity, void[]*p, boolisshared);

Set the array capacity.

If the array capacity isn't currently large enoughto hold the requested capacity (in number of elements), then the array isresized/reallocated to the appropriate size.

Pass in a requested capacity of 0 to get the current capacity.

Parameters:

T	the type of the elements in the array (this should be unqualified)
size_t`newcapacity`	requested new capacity
void[]*`p`	pointer to array to set. Itslength is left unchanged.
bool`isshared`	true if the underlying data is shared

Returns:

the number of elements that can actually be stored once the resizing is done

@trusted size_t_d_arraysetlengthT(Tarr : T[], T)(return ref scope Tarrarr, size_tnewlength);

Resize a dynamic array by setting its.length property.

Newly created elements are initialized based on their default value.If the array's elements initialize to0, memory is zeroed out. Otherwise, elements are explicitly initialized.

This function handles memory allocation, expansion, and initialization while maintaining array integrity.

void main(){int[] a = [1, 2];    a.length = 3;// Gets lowered to `_d_arraysetlengthT!(int)(a, 3, false)`}

Parameters:

Tarr`arr`	The array to resize.
size_t`newlength`	The new value for the array's.length.

Returns:

The resized array with updated length and properly initialized elements.

Throws:

OutOfMemoryError if allocation fails.

Movatterモバイル変換

Library Reference

core.internal.array.capacity