Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

System.arraycopy — copier une plage de tableau

System.arraycopy copie des éléments dans un tableau existant. Les plages qui se chevauchent sont prises en charge, mais les types doivent être compatibles et les limites valides.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

System.arraycopy(src, srcPos, dest, destPos, length);

System.arraycopy copie length éléments de src, à partir de srcPos, vers le tableau existant dest, à partir de destPos. La méthode renvoie void et ne crée pas de nouveau tableau.

Les plages qui se chevauchent fonctionnent comme si un espace temporaire était utilisé. Ce sont les valeurs, y compris les références, qui sont copiées, et non les objets eux-mêmes.

Les types primitifs doivent correspondre exactement. null provoque une NullPointerException ; des limites invalides ou une longueur négative provoquent une IndexOutOfBoundsException. Des arguments qui ne sont pas des tableaux ou des types incompatibles provoquent une ArrayStoreException.

Un élément de référence incompatible peut laisser les éléments précédents déjà copiés ; les erreurs de limites et les incompatibilités de catégorie de tableau ne modifient pas la destination.

Exemples

public class Main {
    public static void main(String[] args) {
        int[] values = {1, 2, 3, 4};
        System.arraycopy(values, 0, values, 1, 3);
        for (int value : values) {
            System.out.println(value);
        }
    }
}

Résultat

1
1
2
3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources