/*************************** asmlib.h *************************************** * Author: Agner Fog * Date created: 2003-12-12 * Last modified: 2013-10-04 * Project: asmlib.zip * Source URL: www.agner.org/optimize * * Description: * Header file for the asmlib function library. * This library is available in many versions for different platforms. * See asmlib-instructions.pdf for details. * * (c) Copyright 2003 - 2013 by Agner Fog. * GNU General Public License http://www.gnu.org/licenses/gpl.html *****************************************************************************/ #ifndef ASMLIB_H #define ASMLIB_H /*********************************************************************** Define compiler-specific types and directives ***********************************************************************/ // Define type size_t #ifndef _SIZE_T_DEFINED #include "stddef.h" #endif // Define integer types with known size: int32_t, uint32_t, int64_t, uint64_t. // If this doesn't work then insert compiler-specific definitions here: #if defined(__GNUC__) || (defined(_MSC_VER) && _MSC_VER >= 1600) // Compilers supporting C99 or C++0x have stdint.h defining these integer types #include #define INT64_SUPPORTED // Remove this if the compiler doesn't support 64-bit integers #elif defined(_MSC_VER) // Older Microsoft compilers have their own definition typedef signed __int16 int16_t; typedef unsigned __int16 uint16_t; typedef signed __int32 int32_t; typedef unsigned __int32 uint32_t; typedef signed __int64 int64_t; typedef unsigned __int64 uint64_t; #define INT64_SUPPORTED // Remove this if the compiler doesn't support 64-bit integers #else // This works with most compilers typedef signed short int int16_t; typedef unsigned short int uint16_t; typedef signed int int32_t; typedef unsigned int uint32_t; typedef long long int64_t; typedef unsigned long long uint64_t; #define INT64_SUPPORTED // Remove this if the compiler doesn't support 64-bit integers #endif // Turn off name mangling #ifdef __cplusplus extern "C" { #endif /*********************************************************************** Function prototypes, memory and string functions ***********************************************************************/ void * A_memcpy (void * dest, const void * src, size_t count); // Copy count bytes from src to dest void * A_memmove(void * dest, const void * src, size_t count); // Same as memcpy, allows overlap between src and dest void * A_memset (void * dest, int c, size_t count); // Set count bytes in dest to (char)c int A_memcmp (const void * buf1, const void * buf2, size_t num); // Compares two blocks of memory size_t GetMemcpyCacheLimit(void); // Data blocks bigger than this will be copied uncached by memcpy and memmove void SetMemcpyCacheLimit(size_t); // Change limit in GetMemcpyCacheLimit size_t GetMemsetCacheLimit(void); // Data blocks bigger than this will be stored uncached by memset void SetMemsetCacheLimit(size_t); // Change limit in GetMemsetCacheLimit char * A_strcat (char * dest, const char * src); // Concatenate strings dest and src. Store result in dest char * A_strcpy (char * dest, const char * src); // Copy string src to dest size_t A_strlen (const char * str); // Get length of zero-terminated string int A_strcmp (const char * a, const char * b); // Compare strings. Case sensitive int A_stricmp (const char *string1, const char *string2); // Compare strings. Case insensitive for A-Z only char * A_strstr (char * haystack, const char * needle); // Search for substring in string void A_strtolower(char * string); // Convert string to lower case for A-Z only void A_strtoupper(char * string); // Convert string to upper case for a-z only size_t A_substring(char * dest, const char * source, size_t pos, size_t len); // Copy a substring for source into dest size_t A_strspn (const char * str, const char * set); // Find span of characters that belong to set size_t A_strcspn(const char * str, const char * set); // Find span of characters that don't belong to set size_t strCountInSet(const char * str, const char * set); // Count characters that belong to set size_t strcount_UTF8(const char * str); // Counts the number of characters in a UTF-8 encoded string /*********************************************************************** Function prototypes, miscellaneous functions ***********************************************************************/ uint32_t A_popcount(uint32_t x); // Count 1-bits in 32-bit integer int RoundD (double x); // Round to nearest or even int RoundF (float x); // Round to nearest or even int InstructionSet(void); // Tell which instruction set is supported char * ProcessorName(void); // ASCIIZ text describing microprocessor void CpuType(int * vendor, int * family, int * model); // Get CPU vendor, family and model size_t DataCacheSize(int level); // Get size of data cache void A_DebugBreak(void); // Makes a debug breakpoint #ifdef INT64_SUPPORTED uint64_t ReadTSC(void); // Read microprocessor internal clock (64 bits) #else uint32_t ReadTSC(void); // Read microprocessor internal clock (only 32 bits supported by compiler) #endif void cpuid_ex (int abcd[4], int eax, int ecx); // call CPUID instruction static inline void cpuid_abcd (int abcd[4], int eax) { cpuid_ex(abcd, eax, 0);} #ifdef __cplusplus } // end of extern "C" // Define overloaded versions if compiling as C++ static inline int Round (double x) { // Overload name Round return RoundD(x);} static inline int Round (float x) { // Overload name Round return RoundF(x);} static inline const char * A_strstr(const char * haystack, const char * needle) { return A_strstr((char*)haystack, needle);} // Overload A_strstr with const char * version #endif // __cplusplus #endif // ASMLIB_H