1Int64(3) OCaml library Int64(3)
2
3
4
6 Int64 - 64-bit integers.
7
9 Module Int64
10
12 Module Int64
13 : sig end
14
15
16 64-bit integers.
17
18 This module provides operations on the type int64 of signed 64-bit in‐
19 tegers. Unlike the built-in int type, the type int64 is guaranteed to
20 be exactly 64-bit wide on all platforms. All arithmetic operations
21 over int64 are taken modulo 2^64
22
23 Performance notice: values of type int64 occupy more memory space than
24 values of type int , and arithmetic operations on int64 are generally
25 slower than those on int . Use int64 only when the application re‐
26 quires exact 64-bit arithmetic.
27
28 Literals for 64-bit integers are suffixed by L:
29 let zero: int64 = 0L
30 let one: int64 = 1L
31 let m_one: int64 = -1L
32
33
34
35
36
37
38
39 val zero : int64
40
41 The 64-bit integer 0.
42
43
44
45 val one : int64
46
47 The 64-bit integer 1.
48
49
50
51 val minus_one : int64
52
53 The 64-bit integer -1.
54
55
56
57 val neg : int64 -> int64
58
59 Unary negation.
60
61
62
63 val add : int64 -> int64 -> int64
64
65 Addition.
66
67
68
69 val sub : int64 -> int64 -> int64
70
71 Subtraction.
72
73
74
75 val mul : int64 -> int64 -> int64
76
77 Multiplication.
78
79
80
81 val div : int64 -> int64 -> int64
82
83 Integer division.
84
85
86 Raises Division_by_zero if the second argument is zero. This division
87 rounds the real quotient of its arguments towards zero, as specified
88 for (/) .
89
90
91
92 val unsigned_div : int64 -> int64 -> int64
93
94 Same as Int64.div , except that arguments and result are interpreted as
95 unsigned 64-bit integers.
96
97
98 Since 4.08.0
99
100
101
102 val rem : int64 -> int64 -> int64
103
104 Integer remainder. If y is not zero, the result of Int64.rem x y sat‐
105 isfies the following property: x = Int64.add (Int64.mul (Int64.div x y)
106 y) (Int64.rem x y) . If y = 0 , Int64.rem x y raises Division_by_zero
107 .
108
109
110
111 val unsigned_rem : int64 -> int64 -> int64
112
113 Same as Int64.rem , except that arguments and result are interpreted as
114 unsigned 64-bit integers.
115
116
117 Since 4.08.0
118
119
120
121 val succ : int64 -> int64
122
123 Successor. Int64.succ x is Int64.add x Int64.one .
124
125
126
127 val pred : int64 -> int64
128
129 Predecessor. Int64.pred x is Int64.sub x Int64.one .
130
131
132
133 val abs : int64 -> int64
134
135
136 abs x is the absolute value of x . On min_int this is min_int itself
137 and thus remains negative.
138
139
140
141 val max_int : int64
142
143 The greatest representable 64-bit integer, 2^63 - 1.
144
145
146
147 val min_int : int64
148
149 The smallest representable 64-bit integer, -2^63.
150
151
152
153 val logand : int64 -> int64 -> int64
154
155 Bitwise logical and.
156
157
158
159 val logor : int64 -> int64 -> int64
160
161 Bitwise logical or.
162
163
164
165 val logxor : int64 -> int64 -> int64
166
167 Bitwise logical exclusive or.
168
169
170
171 val lognot : int64 -> int64
172
173 Bitwise logical negation.
174
175
176
177 val shift_left : int64 -> int -> int64
178
179
180 Int64.shift_left x y shifts x to the left by y bits. The result is un‐
181 specified if y < 0 or y >= 64 .
182
183
184
185 val shift_right : int64 -> int -> int64
186
187
188 Int64.shift_right x y shifts x to the right by y bits. This is an
189 arithmetic shift: the sign bit of x is replicated and inserted in the
190 vacated bits. The result is unspecified if y < 0 or y >= 64 .
191
192
193
194 val shift_right_logical : int64 -> int -> int64
195
196
197 Int64.shift_right_logical x y shifts x to the right by y bits. This is
198 a logical shift: zeroes are inserted in the vacated bits regardless of
199 the sign of x . The result is unspecified if y < 0 or y >= 64 .
200
201
202
203 val of_int : int -> int64
204
205 Convert the given integer (type int ) to a 64-bit integer (type int64
206 ).
207
208
209
210 val to_int : int64 -> int
211
212 Convert the given 64-bit integer (type int64 ) to an integer (type int
213 ). On 64-bit platforms, the 64-bit integer is taken modulo 2^63, i.e.
214 the high-order bit is lost during the conversion. On 32-bit platforms,
215 the 64-bit integer is taken modulo 2^31, i.e. the top 33 bits are lost
216 during the conversion.
217
218
219
220 val unsigned_to_int : int64 -> int option
221
222 Same as Int64.to_int , but interprets the argument as an unsigned inte‐
223 ger. Returns None if the unsigned value of the argument cannot fit
224 into an int .
225
226
227 Since 4.08.0
228
229
230
231 val of_float : float -> int64
232
233 Convert the given floating-point number to a 64-bit integer, discarding
234 the fractional part (truncate towards 0). If the truncated float‐
235 ing-point number is outside the range [ Int64.min_int , Int64.max_int
236 ], no exception is raised, and an unspecified, platform-dependent inte‐
237 ger is returned.
238
239
240
241 val to_float : int64 -> float
242
243 Convert the given 64-bit integer to a floating-point number.
244
245
246
247 val of_int32 : int32 -> int64
248
249 Convert the given 32-bit integer (type int32 ) to a 64-bit integer
250 (type int64 ).
251
252
253
254 val to_int32 : int64 -> int32
255
256 Convert the given 64-bit integer (type int64 ) to a 32-bit integer
257 (type int32 ). The 64-bit integer is taken modulo 2^32, i.e. the top 32
258 bits are lost during the conversion.
259
260
261
262 val of_nativeint : nativeint -> int64
263
264 Convert the given native integer (type nativeint ) to a 64-bit integer
265 (type int64 ).
266
267
268
269 val to_nativeint : int64 -> nativeint
270
271 Convert the given 64-bit integer (type int64 ) to a native integer. On
272 32-bit platforms, the 64-bit integer is taken modulo 2^32. On 64-bit
273 platforms, the conversion is exact.
274
275
276
277 val of_string : string -> int64
278
279 Convert the given string to a 64-bit integer. The string is read in
280 decimal (by default, or if the string begins with 0u ) or in hexadeci‐
281 mal, octal or binary if the string begins with 0x , 0o or 0b respec‐
282 tively.
283
284 The 0u prefix reads the input as an unsigned integer in the range [0,
285 2*Int64.max_int+1] . If the input exceeds Int64.max_int it is con‐
286 verted to the signed integer Int64.min_int + input - Int64.max_int - 1
287 .
288
289 The _ (underscore) character can appear anywhere in the string and is
290 ignored.
291
292
293 Raises Failure if the given string is not a valid representation of an
294 integer, or if the integer represented exceeds the range of integers
295 representable in type int64 .
296
297
298
299 val of_string_opt : string -> int64 option
300
301 Same as of_string , but return None instead of raising.
302
303
304 Since 4.05
305
306
307
308 val to_string : int64 -> string
309
310 Return the string representation of its argument, in decimal.
311
312
313
314 val bits_of_float : float -> int64
315
316 Return the internal representation of the given float according to the
317 IEEE 754 floating-point 'double format' bit layout. Bit 63 of the re‐
318 sult represents the sign of the float; bits 62 to 52 represent the (bi‐
319 ased) exponent; bits 51 to 0 represent the mantissa.
320
321
322
323 val float_of_bits : int64 -> float
324
325 Return the floating-point number whose internal representation, accord‐
326 ing to the IEEE 754 floating-point 'double format' bit layout, is the
327 given int64 .
328
329
330 type t = int64
331
332
333 An alias for the type of 64-bit integers.
334
335
336
337 val compare : t -> t -> int
338
339 The comparison function for 64-bit integers, with the same specifica‐
340 tion as compare . Along with the type t , this function compare allows
341 the module Int64 to be passed as argument to the functors Set.Make and
342 Map.Make .
343
344
345
346 val unsigned_compare : t -> t -> int
347
348 Same as Int64.compare , except that arguments are interpreted as un‐
349 signed 64-bit integers.
350
351
352 Since 4.08.0
353
354
355
356 val equal : t -> t -> bool
357
358 The equal function for int64s.
359
360
361 Since 4.03.0
362
363
364
365 val min : t -> t -> t
366
367 Return the smaller of the two arguments.
368
369
370 Since 4.13.0
371
372
373
374 val max : t -> t -> t
375
376 Return the greater of the two arguments.
377
378
379 Since 4.13.0
380
381
382
383
384
385OCamldoc 2023-07-20 Int64(3)