rem

Reste d’une division

Syntaxe

r = rem(a,b)

Description

r = rem(a,b) renvoie le reste d’une division de a par b, où a est le dividende et b le diviseur. Cette fonction, souvent appelée opération de reste, peut être exprimée ainsi : r = a - b.*fix(a./b). La fonction rem suit la convention selon laquelle rem(a,0) est une valeur NaN.

Exemples

Reste d’une division de scalaire

Calculez le reste de la division de 23 par 5.

a = 23;
b = 5;
r = rem(a,b)

r = 
3

Reste d’une division de vecteur

Trouvez le reste d’une division d’un vecteur de nombres entiers et du diviseur 3.

a = 1:5;
b = 3;
r = rem(a,b)

r = 1×5

     1     2     0     1     2

Reste d’une division de valeurs positives et négatives

Trouvez le reste d’une division pour un jeu de nombres entiers comprenant des valeurs positives et négatives. Remarquez que les résultats non nuls sont du même signe que le dividende.

a = [-4 -1 7 9];
b = 3;
r = rem(a,b)

r = 1×4

    -1    -1     1     0

Reste d’une division pour des valeurs en virgule flottante

Trouvez le reste d’une division pour plusieurs angles avec un diviseur égal à 2*pi. Dans la mesure du possible, rem tente de produire des résultats entiers exacts en compensant les effets d’arrondi des valeurs en virgule flottante.

theta = [0.0 3.5 5.9 6.2 9.0 4*pi];
b = 2*pi;
r = rem(theta,b)

r = 1×6

         0    3.5000    5.9000    6.2000    2.7168         0

Arguments d'entrée

a — Dividende

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Dividende, spécifié sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. a doit être un tableau de valeurs réelles de n’importe quel type numérique. Les entrées a et b doivent être de tailles identiques ou compatibles (par exemple, a est une matrice de dimension M x N et b est un scalaire ou un vecteur ligne de dimension 1 x N). Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

Si a est un tableau duration et b un tableau numérique, les valeurs de b sont traitées comme des nombres de journées de 24 heures.

Si le type de données d’une entrée est entier, l’autre doit disposer du même type de données ou être un double scalaire.

Types de données : single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration | char | table | timetable

b — Diviseur

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Diviseur, spécifié sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. b doit être un tableau de valeurs réelles de n’importe quel type numérique. Les entrées a et b doivent être de tailles identiques ou compatibles (par exemple, a est une matrice de dimension M x N et b est un scalaire ou un vecteur ligne de dimension 1 x N). Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

Si b est un tableau duration et a un tableau numérique, les valeurs de a sont traitées comme des nombres de journées de 24 heures.

Si le type de données d’une entrée est entier, l’autre doit disposer du même type de données ou être un double scalaire.

Types de données : single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration | char | table | timetable

En savoir plus

Différences entre mod et rem

Le concept de reste d’une division n’est pas défini de manière unique. Les fonctions mod et rem calculent chacune une variation différente. La fonction mod produit un résultat qui est soit nul, soit du même signe que le diviseur. La fonction rem produit un résultat qui est soit nul, soit du même signe que le dividende.

Autre différence : la convention lorsque le diviseur est nul. La fonction mod suit la convention selon laquelle mod(a,0) renvoie a, tandis que la fonction rem suit la convention selon laquelle rem(a,0) renvoie NaN.

Les deux variantes ont leur utilité. Par exemple, la fonction mod est utile pour le traitement du signal dans le contexte de signaux périodiques, car sa sortie est périodique (période égale au diviseur).

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction rem supporte entièrement les tall arrays. Pour plus d’informations, consultez Tall array.

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Le code généré effectue les calculs arithmétiques en utilisant la classe en sortie. Les résultats pourraient ne pas correspondre à MATLAB^® en raison de différences dans les erreurs d’arrondi.

• Si l’une des entrées est de type int64 ou uint64, les deux entrées doivent être du même type.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction rem supporte entièrement les GPU arrays. Pour exécuter la fonction sur un GPU, spécifiez les données en entrée en tant que gpuArray (Parallel Computing Toolbox). Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Cette fonction supporte entièrement les distributed arrays. Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2023a: Effectuer des calculs directement dans les tableaux et les timetables

La fonction rem peut procéder au calcul sur toutes les variables au sein d’un tableau ou d’une timetable sans indexation pour accéder à ces variables. Toutes les variables doivent avoir des types de données qui supportent les calculs. Pour plus d’informations, consultez Direct Calculations on Tables and Timetables.

Voir aussi

mod