Nugget
eaunits.h
1 /*-----------------------------------------------------------------------------
2  * eaunits.h
3  *
4  * Copyright (c) Electronic Arts Inc. All rights reserved.
5  *---------------------------------------------------------------------------*/
6 
7 
8 #ifndef INCLUDED_eaunits_h
9 #define INCLUDED_eaunits_h
10 
11 #include <EABase/eabase.h>
12 
13 #if defined(EA_PRAGMA_ONCE_SUPPORTED)
14  #pragma once // Some compilers (e.g. VC++) benefit significantly from using this. We've measured 3-4% build speed improvements in apps as a result.
15 #endif
16 
17 // Defining common SI unit macros.
18 //
19 // The mebibyte is a multiple of the unit byte for digital information. Technically a
20 // megabyte (MB) is a power of ten, while a mebibyte (MiB) is a power of two,
21 // appropriate for binary machines. Many Linux distributions use the unit, but it is
22 // not widely acknowledged within the industry or media.
23 // Reference: https://en.wikipedia.org/wiki/Mebibyte
24 //
25 // Examples:
26 // auto size1 = EA_KILOBYTE(16);
27 // auto size2 = EA_MEGABYTE(128);
28 // auto size3 = EA_MEBIBYTE(8);
29 // auto size4 = EA_GIBIBYTE(8);
30 
31 // define byte for completeness
32 #define EA_BYTE(x) (x)
33 
34 // Decimal SI units
35 #define EA_KILOBYTE(x) (size_t(x) * 1000)
36 #define EA_MEGABYTE(x) (size_t(x) * 1000 * 1000)
37 #define EA_GIGABYTE(x) (size_t(x) * 1000 * 1000 * 1000)
38 #define EA_TERABYTE(x) (size_t(x) * 1000 * 1000 * 1000 * 1000)
39 #define EA_PETABYTE(x) (size_t(x) * 1000 * 1000 * 1000 * 1000 * 1000)
40 #define EA_EXABYTE(x) (size_t(x) * 1000 * 1000 * 1000 * 1000 * 1000 * 1000)
41 
42 // Binary SI units
43 #define EA_KIBIBYTE(x) (size_t(x) * 1024)
44 #define EA_MEBIBYTE(x) (size_t(x) * 1024 * 1024)
45 #define EA_GIBIBYTE(x) (size_t(x) * 1024 * 1024 * 1024)
46 #define EA_TEBIBYTE(x) (size_t(x) * 1024 * 1024 * 1024 * 1024)
47 #define EA_PEBIBYTE(x) (size_t(x) * 1024 * 1024 * 1024 * 1024 * 1024)
48 #define EA_EXBIBYTE(x) (size_t(x) * 1024 * 1024 * 1024 * 1024 * 1024 * 1024)
49 
50 #endif // INCLUDED_earesult_H
51 
52 
53 
54