In
mathematics
Mathematics is an area of knowledge that includes the topics of numbers, formulas and related structures, shapes and the spaces in which they are contained, and quantities and their changes. These topics are represented in modern mathematics ...
, modular arithmetic is a system of
arithmetic
Arithmetic () is an elementary part of mathematics that consists of the study of the properties of the traditional operations on numbers— addition, subtraction, multiplication, division, exponentiation, and extraction of roots. In the 19th ...
for
integers, where numbers "wrap around" when reaching a certain value, called the modulus. The modern approach to modular arithmetic was developed by
Carl Friedrich Gauss in his book ''
Disquisitiones Arithmeticae'', published in 1801.
A familiar use of modular arithmetic is in the
12-hour clock
The 12-hour clock is a time convention in which the 24 hours of the day are divided into two periods: a.m. (from Latin , translating to "before midday") and p.m. (from Latin , translating to "after midday"). For different opinions on represent ...
, in which the day is divided into two 12-hour periods. If the time is 7:00 now, then 8 hours later it will be 3:00. Simple addition would result in , but clocks "wrap around" every 12 hours. Because the hour number starts over at zero when it reaches 12, this is arithmetic ''modulo'' 12. In terms of the definition below, 15 is ''congruent'' to 3 modulo 12, so "15:00" on a
24-hour clock
The modern 24-hour clock, popularly referred to in the United States as military time, is the convention of timekeeping in which the day runs from midnight to midnight and is divided into 24 hours. This is indicated by the hours (and minutes) pas ...
is displayed "3:00" on a 12-hour clock.
Congruence
Given an
integer , called a modulus, two integers and are said to be congruent modulo , if is a
divisor of their difference (that is, if there is an integer such that ).
Congruence modulo is a
congruence relation
In abstract algebra, a congruence relation (or simply congruence) is an equivalence relation on an algebraic structure (such as a group, ring, or vector space) that is compatible with the structure in the sense that algebraic operations done wi ...
, meaning that it is an
equivalence relation
In mathematics, an equivalence relation is a binary relation that is reflexive, symmetric and transitive. The equipollence relation between line segments in geometry is a common example of an equivalence relation.
Each equivalence relation ...
that is compatible with the operations of
addition
Addition (usually signified by the Plus and minus signs#Plus sign, plus symbol ) is one of the four basic Operation (mathematics), operations of arithmetic, the other three being subtraction, multiplication and Division (mathematics), division. ...
,
subtraction
Subtraction is an arithmetic operation that represents the operation of removing objects from a collection. Subtraction is signified by the minus sign, . For example, in the adjacent picture, there are peaches—meaning 5 peaches with 2 taken ...
, and
multiplication
Multiplication (often denoted by the cross symbol , by the mid-line dot operator , by juxtaposition, or, on computers, by an asterisk ) is one of the four elementary mathematical operations of arithmetic, with the other ones being additi ...
. Congruence modulo is denoted:
:
The parentheses mean that applies to the entire equation, not just to the right-hand side (here, ). This notation is not to be confused with the notation (without parentheses), which refers to the
modulo operation. Indeed, denotes the unique integer such that and
(that is, the remainder of
when divided by
).
The congruence relation may be rewritten as
:
explicitly showing its relationship with
Euclidean division. However, the here need not be the remainder of the division of by Instead, what the statement asserts is that and have the same remainder when divided by . That is,
:
:
where is the common remainder. Subtracting these two expressions, we recover the previous relation:
:
by setting
Examples
In modulus 12, one can assert that:
:
because , which is a multiple of 12. Another way to express this is to say that both 38 and 14 have the same remainder 2, when divided by 12.
The definition of congruence also applies to negative values. For example:
:
Properties
The congruence relation satisfies all the conditions of an
equivalence relation
In mathematics, an equivalence relation is a binary relation that is reflexive, symmetric and transitive. The equipollence relation between line segments in geometry is a common example of an equivalence relation.
Each equivalence relation ...
:
* Reflexivity:
* Symmetry: if for all , , and .
* Transitivity: If and , then
If and or if then:
* for any integer (compatibility with translation)
* for any integer (compatibility with scaling)
* for any integer
* (compatibility with addition)
* (compatibility with subtraction)
* (compatibility with multiplication)
* for any non-negative integer (compatibility with exponentiation)
* , for any
polynomial with integer coefficients (compatibility with polynomial evaluation)
If , then it is generally false that . However, the following is true:
* If where is
Euler's totient function
In number theory, Euler's totient function counts the positive integers up to a given integer that are relatively prime to . It is written using the Greek letter phi as \varphi(n) or \phi(n), and may also be called Euler's phi function. In ot ...
, then —provided that is
coprime with .
For cancellation of common terms, we have the following rules:
* If , where is any integer, then
* If and is coprime with , then
* If and , then
The
modular multiplicative inverse is defined by the following rules:
* Existence: there exists an integer denoted such that if and only if is coprime with . This integer is called a ''modular multiplicative inverse'' of modulo .
* If and exists, then (compatibility with multiplicative inverse, and, if , uniqueness modulo )
* If and is coprime to , then the solution to this linear congruence is given by
The multiplicative inverse may be efficiently computed by solving
Bézout's equation for
—using the
Extended Euclidean algorithm
In arithmetic and computer programming, the extended Euclidean algorithm is an extension to the Euclidean algorithm, and computes, in addition to the greatest common divisor (gcd) of integers ''a'' and ''b'', also the coefficients of Bézout's ide ...
.
In particular, if is a prime number, then is coprime with for every such that ; thus a multiplicative inverse exists for all that is not congruent to zero modulo .
Some of the more advanced properties of congruence relations are the following:
*
Fermat's little theorem
Fermat's little theorem states that if ''p'' is a prime number, then for any integer ''a'', the number a^p - a is an integer multiple of ''p''. In the notation of modular arithmetic, this is expressed as
: a^p \equiv a \pmod p.
For example, if = ...
: If is prime and does not divide , then .
*
Euler's theorem
In number theory, Euler's theorem (also known as the Fermat–Euler theorem or Euler's totient theorem) states that, if and are coprime positive integers, and \varphi(n) is Euler's totient function, then raised to the power \varphi(n) is congru ...
: If and are coprime, then , where is
Euler's totient function
In number theory, Euler's totient function counts the positive integers up to a given integer that are relatively prime to . It is written using the Greek letter phi as \varphi(n) or \phi(n), and may also be called Euler's phi function. In ot ...
* A simple consequence of Fermat's little theorem is that if is prime, then is the multiplicative inverse of . More generally, from Euler's theorem, if and are coprime, then .
* Another simple consequence is that if where is Euler's totient function, then provided is
coprime with .
*
Wilson's theorem: is prime if and only if .
*
Chinese remainder theorem
In mathematics, the Chinese remainder theorem states that if one knows the remainders of the Euclidean division of an integer ''n'' by several integers, then one can determine uniquely the remainder of the division of ''n'' by the product of thes ...
: For any , and coprime , , there exists a unique such that and . In fact, where is the inverse of modulo and is the inverse of modulo .
*
Lagrange's theorem: The congruence , where is prime, and is a
polynomial with integer coefficients such that , has at most roots.
*
Primitive root modulo : A number is a primitive root modulo if, for every integer coprime to , there is an integer such that . A primitive root modulo exists if and only if is equal to or , where is an odd prime number and is a positive integer. If a primitive root modulo exists, then there are exactly such primitive roots, where is the Euler's totient function.
*
Quadratic residue
In number theory, an integer ''q'' is called a quadratic residue modulo ''n'' if it is congruent to a perfect square modulo ''n''; i.e., if there exists an integer ''x'' such that:
:x^2\equiv q \pmod.
Otherwise, ''q'' is called a quadratic no ...
: An integer is a quadratic residue modulo , if there exists an integer such that .
Euler's criterion In number theory, Euler's criterion is a formula for determining whether an integer is a quadratic residue modulo a prime. Precisely,
Let ''p'' be an odd prime and ''a'' be an integer coprime to ''p''. Then
:
a^ \equiv
\begin
\;\;\,1\pmod& \text ...
asserts that, if is an odd prime, and is not a multiple of , then is a quadratic residue modulo if and only if
::
Congruence classes
Like any congruence relation, congruence modulo is an
equivalence relation
In mathematics, an equivalence relation is a binary relation that is reflexive, symmetric and transitive. The equipollence relation between line segments in geometry is a common example of an equivalence relation.
Each equivalence relation ...
, and the
equivalence class
In mathematics, when the elements of some set S have a notion of equivalence (formalized as an equivalence relation), then one may naturally split the set S into equivalence classes. These equivalence classes are constructed so that elements a ...
of the integer , denoted by , is the set . This set, consisting of all the integers congruent to modulo , is called the congruence class, residue class, or simply residue of the integer modulo . When the modulus is known from the context, that residue may also be denoted .
Residue systems
Each residue class modulo may be represented by any one of its members, although we usually represent each residue class by the smallest nonnegative integer which belongs to that class (since this is the proper remainder which results from division). Any two members of different residue classes modulo are incongruent modulo . Furthermore, every integer belongs to one and only one residue class modulo .
The set of integers is called the least residue system modulo . Any set of integers, no two of which are congruent modulo , is called a complete residue system modulo .
The least residue system is a complete residue system, and a complete residue system is simply a set containing precisely one
representative of each residue class modulo . For example. the least residue system modulo 4 is . Some other complete residue systems modulo 4 include:
*
*
*
*
*
*
Some sets which are ''not'' complete residue systems modulo 4 are:
*, since 6 is congruent to 22 modulo 4.
*, since a complete residue system modulo 4 must have exactly 4 incongruent residue classes.
Reduced residue systems
Given the
Euler's totient function
In number theory, Euler's totient function counts the positive integers up to a given integer that are relatively prime to . It is written using the Greek letter phi as \varphi(n) or \phi(n), and may also be called Euler's phi function. In ot ...
, any set of integers that are
relatively prime to and mutually incongruent under modulus is called a reduced residue system modulo . The set from above, for example, is an instance of a reduced residue system modulo 4.
Integers modulo ''n''
The set of all
congruence classes of the integers for a modulus is called the ring of integers modulo , and is denoted
,
, or
. The notation
is, however, not recommended because it can be confused with the set of
-adic integers. The
ring is fundamental to various branches of mathematics (see below).
The set is defined for ''n'' > 0 as:
:
(When ,
is not an
empty set
In mathematics, the empty set is the unique set having no elements; its size or cardinality (count of elements in a set) is zero. Some axiomatic set theories ensure that the empty set exists by including an axiom of empty set, while in other ...
; rather, it is
isomorphic
In mathematics, an isomorphism is a structure-preserving mapping between two structures of the same type that can be reversed by an inverse mapping. Two mathematical structures are isomorphic if an isomorphism exists between them. The word is ...
to
, since .)
We define addition, subtraction, and multiplication on
by the following rules:
*
*
*
The verification that this is a proper definition uses the properties given before.
In this way,
becomes a
commutative ring
In mathematics, a commutative ring is a ring in which the multiplication operation is commutative. The study of commutative rings is called commutative algebra. Complementarily, noncommutative algebra is the study of ring properties that are not sp ...
. For example, in the ring
, we have
:
as in the arithmetic for the 24-hour clock.
We use the notation
because this is the
quotient ring of
by the
ideal , a set containing all integers divisible by , where
is the
singleton set . Thus
is a
field when
is a
maximal ideal (i.e., when is prime).
This can also be constructed from the group
under the addition operation alone. The residue class is the group
coset of in the
quotient group
A quotient group or factor group is a mathematical group obtained by aggregating similar elements of a larger group using an equivalence relation that preserves some of the group structure (the rest of the structure is "factored" out). For examp ...
, a
cyclic group.
Rather than excluding the special case , it is more useful to include
(which, as mentioned before, is isomorphic to the ring
of integers). In fact, this inclusion is useful when discussing the
characteristic of a
ring.
The ring of integers modulo is a
finite field if and only if is
prime (this ensures that every nonzero element has a
multiplicative inverse). If
is a
prime power with ''k'' > 1, there exists a unique (up to isomorphism) finite field
with elements, but this is ''not''
, which fails to be a field because it has
zero-divisors.
The
multiplicative subgroup of integers modulo ''n'' is denoted by
. This consists of
(where ''a''
is coprime to ''n''), which are precisely the classes possessing a multiplicative inverse. This forms a commutative
group under multiplication, with order
.
Extension to real numbers
Applications
In theoretical mathematics, modular arithmetic is one of the foundations of
number theory, touching on almost every aspect of its study, and it is also used extensively in
group theory,
ring theory,
knot theory
In the mathematical field of topology, knot theory is the study of knot (mathematics), mathematical knots. While inspired by knots which appear in daily life, such as those in shoelaces and rope, a mathematical knot differs in that the ends are ...
, and
abstract algebra. In applied mathematics, it is used in
computer algebra
In mathematics and computer science, computer algebra, also called symbolic computation or algebraic computation, is a scientific area that refers to the study and development of algorithms and software for manipulating mathematical expressions ...
,
cryptography,
computer science,
chemistry
Chemistry is the science, scientific study of the properties and behavior of matter. It is a natural science that covers the Chemical element, elements that make up matter to the chemical compound, compounds made of atoms, molecules and ions ...
and the
visual and
musical arts.
A very practical application is to calculate checksums within serial number identifiers. For example,
International Standard Book Number (ISBN) uses modulo 11 (for 10 digit ISBN) or modulo 10 (for 13 digit ISBN) arithmetic for error detection. Likewise,
International Bank Account Numbers (IBANs), for example, make use of modulo 97 arithmetic to spot user input errors in bank account numbers. In chemistry, the last digit of the
CAS registry number (a unique identifying number for each chemical compound) is a
check digit, which is calculated by taking the last digit of the first two parts of the CAS registry number times 1, the previous digit times 2, the previous digit times 3 etc., adding all these up and computing the sum modulo 10.
In cryptography, modular arithmetic directly underpins
public key systems such as
RSA
RSA may refer to:
Organizations Academia and education
* Rabbinical Seminary of America, a yeshiva in New York City
*Regional Science Association International (formerly the Regional Science Association), a US-based learned society
*Renaissance S ...
and
Diffie–Hellman, and provides
finite fields which underlie
elliptic curves, and is used in a variety of
symmetric key algorithms including
Advanced Encryption Standard (AES),
International Data Encryption Algorithm (IDEA), and
RC4. RSA and Diffie–Hellman use
modular exponentiation.
In computer algebra, modular arithmetic is commonly used to limit the size of integer coefficients in intermediate calculations and data. It is used in
polynomial factorization, a problem for which all known efficient algorithms use modular arithmetic. It is used by the most efficient implementations of
polynomial greatest common divisor, exact
linear algebra and
Gröbner basis algorithms over the integers and the rational numbers. As posted on
Fidonet in the 1980s and archived at
Rosetta Code
Rosetta Code is a wiki-based programming website with implementations of common algorithms and solutions to various programming problems in many different programming languages. It is named for the Rosetta Stone, which has the same text inscribe ...
, modular arithmetic was used to disprove
Euler's sum of powers conjecture on a
Sinclair QL microcomputer
A microcomputer is a small, relatively inexpensive computer having a central processing unit (CPU) made out of a microprocessor. The computer also includes memory and input/output (I/O) circuitry together mounted on a printed circuit board (PC ...
using just one-fourth of the integer precision used by a
CDC 6600 supercomputer
A supercomputer is a computer with a high level of performance as compared to a general-purpose computer. The performance of a supercomputer is commonly measured in floating-point operations per second ( FLOPS) instead of million instructions ...
to disprove it two decades earlier via a
brute force search.
In computer science, modular arithmetic is often applied in
bitwise operation
In computer programming, a bitwise operation operates on a bit string, a bit array or a binary numeral (considered as a bit string) at the level of its individual bits. It is a fast and simple action, basic to the higher-level arithmetic operati ...
s and other operations involving fixed-width, cyclic
data structure
In computer science, a data structure is a data organization, management, and storage format that is usually chosen for efficient access to data. More precisely, a data structure is a collection of data values, the relationships among them, a ...
s. The
modulo operation, as implemented in many
programming languages and
calculator
An electronic calculator is typically a portable electronic device used to perform calculations, ranging from basic arithmetic to complex mathematics.
The first solid-state electronic calculator was created in the early 1960s. Pocket-sized ...
s, is an application of modular arithmetic that is often used in this context. The logical operator
XOR
Exclusive or or exclusive disjunction is a logical operation that is true if and only if its arguments differ (one is true, the other is false).
It is symbolized by the prefix operator J and by the infix operators XOR ( or ), EOR, EXOR, , ...
sums 2 bits, modulo 2.
In music, arithmetic modulo 12 is used in the consideration of the system of
twelve-tone equal temperament, where
octave
In music, an octave ( la, octavus: eighth) or perfect octave (sometimes called the diapason) is the interval between one musical pitch and another with double its frequency. The octave relationship is a natural phenomenon that has been refer ...
and
enharmonic
In modern musical notation and tuning, an enharmonic equivalent is a note, interval, or key signature that is equivalent to some other note, interval, or key signature but "spelled", or named differently. The enharmonic spelling of a written n ...
equivalency occurs (that is, pitches in a 1:2 or 2:1 ratio are equivalent, and C-
sharp is considered the same as D-
flat).
The method of
casting out nines offers a quick check of decimal arithmetic computations performed by hand. It is based on modular arithmetic modulo 9, and specifically on the crucial property that 10 ≡ 1 (mod 9).
Arithmetic modulo 7 is used in algorithms that determine the day of the week for a given date. In particular,
Zeller's congruence and the
Doomsday algorithm
The Doomsday rule, Doomsday algorithm or Doomsday method is an algorithm of determination of the day of the week for a given date. It provides a perpetual calendar because the Gregorian calendar moves in cycles of 400 years. The algorithm for men ...
make heavy use of modulo-7 arithmetic.
More generally, modular arithmetic also has application in disciplines such as
law (e.g.,
apportionment
The legal term apportionment (french: apportionement; Mediaeval Latin: , derived from la, portio, share), also called delimitation, is in general the distribution or allotment of proper shares, though may have different meanings in different c ...
),
economics (e.g.,
game theory
Game theory is the study of mathematical models of strategic interactions among rational agents. Myerson, Roger B. (1991). ''Game Theory: Analysis of Conflict,'' Harvard University Press, p.&nbs1 Chapter-preview links, ppvii–xi It has appli ...
) and other areas of the
social sciences, where
proportional
Proportionality, proportion or proportional may refer to:
Mathematics
* Proportionality (mathematics), the property of two variables being in a multiplicative relation to a constant
* Ratio, of one quantity to another, especially of a part compare ...
division and allocation of resources plays a central part of the analysis.
Computational complexity
Since modular arithmetic has such a wide range of applications, it is important to know how hard it is to solve a system of congruences. A linear system of congruences can be solved in
polynomial time
In computer science, the time complexity is the computational complexity that describes the amount of computer time it takes to run an algorithm. Time complexity is commonly estimated by counting the number of elementary operations performed by ...
with a form of
Gaussian elimination
In mathematics, Gaussian elimination, also known as row reduction, is an algorithm for solving systems of linear equations. It consists of a sequence of operations performed on the corresponding matrix of coefficients. This method can also be used ...
, for details see
linear congruence theorem. Algorithms, such as
Montgomery reduction, also exist to allow simple arithmetic operations, such as multiplication and
exponentiation modulo , to be performed efficiently on large numbers.
Some operations, like finding a
discrete logarithm
In mathematics, for given real numbers ''a'' and ''b'', the logarithm log''b'' ''a'' is a number ''x'' such that . Analogously, in any group ''G'', powers ''b'k'' can be defined for all integers ''k'', and the discrete logarithm log''b' ...
or a
quadratic congruence appear to be as hard as
integer factorization
In number theory, integer factorization is the decomposition of a composite number into a product of smaller integers. If these factors are further restricted to prime numbers, the process is called prime factorization.
When the numbers are suf ...
and thus are a starting point for
cryptographic algorithms and
encryption. These problems might be
NP-intermediate.
Solving a system of non-linear modular arithmetic equations is
NP-complete.
Example implementations
Below are three reasonably fast C functions, two for performing modular multiplication and one for modular exponentiation on unsigned integers not larger than 63 bits, without overflow of the transient operations.
An algorithmic way to compute
:
[This code uses the C literal notation for unsigned long long hexadecimal numbers, which end with ]ULL
. See also section 6.4.4 of the language specificatio
n1570
uint64_t mul_mod(uint64_t a, uint64_t b, uint64_t m)
On computer architectures where an
extended precision
Extended precision refers to floating-point arithmetic, floating-point number formats that provide greater precision (computer science), precision than the basic floating-point formats. Extended precision formats support a basic format by floati ...
format with at least 64 bits of mantissa is available (such as the
long double type of most x86 C compilers), the following routine is faster than a solution using a loop, by employing the trick that, by hardware,
floating-point
In computing, floating-point arithmetic (FP) is arithmetic that represents real numbers approximately, using an integer with a fixed precision, called the significand, scaled by an integer exponent of a fixed base. For example, 12.345 can b ...
multiplication results in the most significant bits of the product kept, while integer multiplication results in the least significant bits kept:
uint64_t mul_mod(uint64_t a, uint64_t b, uint64_t m)
Below is a C function for performing modular exponentiation, that uses the function implemented above.
An algorithmic way to compute
:
uint64_t pow_mod(uint64_t a, uint64_t b, uint64_t m)
However, for all above routines to work, must not exceed 63 bits.
See also
*
Boolean ring
*
Circular buffer
*
Division (mathematics)
Division is one of the four basic operations of arithmetic, the ways that numbers are combined to make new numbers. The other operations are addition, subtraction, and multiplication.
At an elementary level the division of two natural number ...
*
Finite field
*
Legendre symbol
In number theory, the Legendre symbol is a multiplicative function with values 1, −1, 0 that is a quadratic character modulo an odd prime number ''p'': its value at a (nonzero) quadratic residue mod ''p'' is 1 and at a non-quadratic residu ...
*
Modular exponentiation
*
Modulo (mathematics)
*
Multiplicative group of integers modulo n
*
Pisano period (Fibonacci sequences modulo ''n'')
*
Primitive root modulo n
In modular arithmetic, a number is a primitive root modulo if every number coprime to is congruent to a power of modulo . That is, is a ''primitive root modulo'' if for every integer coprime to , there is some integer for which ...
*
Quadratic reciprocity
*
Quadratic residue
In number theory, an integer ''q'' is called a quadratic residue modulo ''n'' if it is congruent to a perfect square modulo ''n''; i.e., if there exists an integer ''x'' such that:
:x^2\equiv q \pmod.
Otherwise, ''q'' is called a quadratic no ...
*
Rational reconstruction (mathematics)
*
Reduced residue system
*
Serial number arithmetic (a special case of modular arithmetic)
*
Two-element Boolean algebra
* Topics relating to the group theory behind modular arithmetic:
**
Cyclic group
**
Multiplicative group of integers modulo n
* Other important theorems relating to modular arithmetic:
**
Carmichael's theorem
**
Chinese remainder theorem
In mathematics, the Chinese remainder theorem states that if one knows the remainders of the Euclidean division of an integer ''n'' by several integers, then one can determine uniquely the remainder of the division of ''n'' by the product of thes ...
**
Euler's theorem
In number theory, Euler's theorem (also known as the Fermat–Euler theorem or Euler's totient theorem) states that, if and are coprime positive integers, and \varphi(n) is Euler's totient function, then raised to the power \varphi(n) is congru ...
**
Fermat's little theorem
Fermat's little theorem states that if ''p'' is a prime number, then for any integer ''a'', the number a^p - a is an integer multiple of ''p''. In the notation of modular arithmetic, this is expressed as
: a^p \equiv a \pmod p.
For example, if = ...
(a special case of Euler's theorem)
**
Lagrange's theorem
**
Thue's lemma
In modular arithmetic, Thue's lemma roughly states that every modular integer may be represented by a "modular fraction" such that the numerator and the denominator have absolute values not greater than the square root of the modulus.
More preci ...
Notes
References
* John L. Berggren
"modular arithmetic" Encyclopædia Britannica.
* . See in particular chapters 5 and 6 for a review of basic modular arithmetic.
* Maarten Bullynck
Modular Arithmetic before C.F. Gauss. Systematisations and discussions on remainder problems in 18th-century Germany
*
Thomas H. Cormen,
Charles E. Leiserson,
Ronald L. Rivest, and
Clifford Stein. ''
Introduction to Algorithms'', Second Edition. MIT Press and McGraw-Hill, 2001. . Section 31.3: Modular arithmetic, pp. 862–868.
Anthony Gioia ''Number Theory, an Introduction'' Reprint (2001) Dover. .
*
*
*
External links
*
* In thi
article, one can learn more about applications of modular arithmetic in art.
* A
articleon modular arithmetic on the GIMPS wiki
Modular Arithmetic and patterns in addition and multiplication tables
{{Number theory
Finite rings
Group theory
Articles with example C code