Detailed Description

Namespaces

 TypeHelpers
 This namespace contains a few template classes for helping work out class type variations.
 

Classes

class  BigInteger
 An arbitrarily large integer class. More...
 
class  Expression
 A class for dynamically evaluating simple numeric expressions. More...
 
struct  Expression::Symbol
 Represents a symbol that is used in an Expression. More...
 
class  Expression::Scope::Visitor
 Used as a callback by the Scope::visitRelativeScope() method. More...
 
class  Expression::Scope
 When evaluating an Expression object, this class is used to resolve symbols and perform functions that the expression uses. More...
 
struct  MathConstants< FloatType >
 Commonly used mathematical constants. More...
 
struct  TypeHelpers::ParameterType< Type >
 The ParameterType struct is used to find the best type to use when passing some kind of object as a parameter. More...
 
struct  TypeHelpers::SmallestFloatType< Type >
 These templates are designed to take a type, and if it's a double, they return a double type; for anything else, they return a float type. More...
 
struct  TypeHelpers::SmallestFloatType< double >
 
struct  TypeHelpers::UnsignedTypeWithSize< 1 >
 
struct  TypeHelpers::UnsignedTypeWithSize< 2 >
 
struct  TypeHelpers::UnsignedTypeWithSize< 4 >
 
struct  TypeHelpers::UnsignedTypeWithSize< 8 >
 
class  NormalisableRange< ValueType >
 Represents a mapping between an arbitrary range of values and a normalised 0->1 range. More...
 
class  Random
 A random number generator. More...
 
class  Range< ValueType >
 A general-purpose range object, that simply represents any linear range with a start and end point. More...
 
class  StatisticsAccumulator< FloatType >
 A class that measures various statistics about a series of floating point values that it is given. More...
 

Macros

#define JUCE_UNDENORMALISE(x)   { (x) += 0.1f; (x) -= 0.1f; }
 This macro can be applied to a float variable to check whether it contains a denormalised value, and to normalise it if necessary. More...
 

Typedefs

typedef signed char int8
 A platform-independent 8-bit signed integer type. More...
 
typedef unsigned char uint8
 A platform-independent 8-bit unsigned integer type. More...
 
typedef signed short int16
 A platform-independent 16-bit signed integer type. More...
 
typedef unsigned short uint16
 A platform-independent 16-bit unsigned integer type. More...
 
typedef signed int int32
 A platform-independent 32-bit signed integer type. More...
 
typedef unsigned int uint32
 A platform-independent 32-bit unsigned integer type. More...
 
typedef long long int64
 A platform-independent 64-bit integer type. More...
 
typedef unsigned long long uint64
 A platform-independent 64-bit unsigned integer type. More...
 
typedef int pointer_sized_int
 A signed integer type that's guaranteed to be large enough to hold a pointer without truncating it. More...
 
typedef unsigned int pointer_sized_uint
 An unsigned integer type that's guaranteed to be large enough to hold a pointer without truncating it. More...
 

Functions

OutputStream &JUCE_CALLTYPE operator<< (OutputStream &stream, const BigInteger &value)
 Writes a BigInteger to an OutputStream as a UTF8 decimal string. More...
 
template<typename Type >
Type jmax (const Type a, const Type b)
 Returns the larger of two values. More...
 
template<typename Type >
Type jmax (const Type a, const Type b, const Type c)
 Returns the larger of three values. More...
 
template<typename Type >
Type jmax (const Type a, const Type b, const Type c, const Type d)
 Returns the larger of four values. More...
 
template<typename Type >
Type jmin (const Type a, const Type b)
 Returns the smaller of two values. More...
 
template<typename Type >
Type jmin (const Type a, const Type b, const Type c)
 Returns the smaller of three values. More...
 
template<typename Type >
Type jmin (const Type a, const Type b, const Type c, const Type d)
 Returns the smaller of four values. More...
 
template<typename Type >
Type jmap (Type value0To1, Type targetRangeMin, Type targetRangeMax)
 Remaps a normalised value (between 0 and 1) to a target range. More...
 
template<typename Type >
Type jmap (Type sourceValue, Type sourceRangeMin, Type sourceRangeMax, Type targetRangeMin, Type targetRangeMax)
 Remaps a value from a source range to a target range. More...
 
template<typename Type >
Type findMinimum (const Type *data, int numValues)
 Scans an array of values, returning the minimum value that it contains. More...
 
template<typename Type >
Type findMaximum (const Type *values, int numValues)
 Scans an array of values, returning the maximum value that it contains. More...
 
template<typename Type >
void findMinAndMax (const Type *values, int numValues, Type &lowest, Type &highest)
 Scans an array of values, returning the minimum and maximum values that it contains. More...
 
template<typename Type >
Type jlimit (Type lowerLimit, Type upperLimit, Type valueToConstrain) noexcept
 Constrains a value to keep it within a given range. More...
 
template<typename Type1 , typename Type2 >
bool isPositiveAndBelow (Type1 valueToTest, Type2 upperLimit) noexcept
 Returns true if a value is at least zero, and also below a specified upper limit. More...
 
template<typename Type >
bool isPositiveAndBelow (int valueToTest, Type upperLimit) noexcept
 
template<typename Type1 , typename Type2 >
bool isPositiveAndNotGreaterThan (Type1 valueToTest, Type2 upperLimit) noexcept
 Returns true if a value is at least zero, and also less than or equal to a specified upper limit. More...
 
template<typename Type >
bool isPositiveAndNotGreaterThan (int valueToTest, Type upperLimit) noexcept
 
template<typename Type1 >
void ignoreUnused (const Type1 &) noexcept
 Handy function for avoiding unused variables warning. More...
 
template<typename Type1 , typename Type2 >
void ignoreUnused (const Type1 &, const Type2 &) noexcept
 
template<typename Type1 , typename Type2 , typename Type3 >
void ignoreUnused (const Type1 &, const Type2 &, const Type3 &) noexcept
 
template<typename Type1 , typename Type2 , typename Type3 , typename Type4 >
void ignoreUnused (const Type1 &, const Type2 &, const Type3 &, const Type4 &) noexcept
 
template<typename Type , int N>
int numElementsInArray (Type(&array)[N])
 Handy function for getting the number of elements in a simple const C array. More...
 
template<typename Type >
Type juce_hypot (Type a, Type b) noexcept
 Using juce_hypot is easier than dealing with the different types of hypot function that are provided by the various platforms and compilers. More...
 
int64 abs64 (const int64 n) noexcept
 64-bit abs function. More...
 
float degreesToRadians (float degrees) noexcept
 Converts an angle in degrees to radians. More...
 
double degreesToRadians (double degrees) noexcept
 Converts an angle in degrees to radians. More...
 
float radiansToDegrees (float radians) noexcept
 Converts an angle in radians to degrees. More...
 
double radiansToDegrees (double radians) noexcept
 Converts an angle in radians to degrees. More...
 
template<typename NumericType >
bool juce_isfinite (NumericType) noexcept
 The isfinite() method seems to vary between platforms, so this is a platform-independent function for it. More...
 
template<>
bool juce_isfinite (float value) noexcept
 
template<>
bool juce_isfinite (double value) noexcept
 
template<typename FloatType >
int roundToInt (const FloatType value) noexcept
 Fast floating-point-to-integer conversion. More...
 
int roundToInt (int value) noexcept
 
int roundToIntAccurate (double value) noexcept
 Fast floating-point-to-integer conversion. More...
 
int roundDoubleToInt (double value) noexcept
 Fast floating-point-to-integer conversion. More...
 
int roundFloatToInt (float value) noexcept
 Fast floating-point-to-integer conversion. More...
 
template<typename FloatType >
unsigned int truncatePositiveToUnsignedInt (FloatType value) noexcept
 Truncates a positive floating-point number to an unsigned int. More...
 
template<typename IntegerType >
bool isPowerOfTwo (IntegerType value)
 Returns true if the specified integer is a power-of-two. More...
 
int nextPowerOfTwo (int n) noexcept
 Returns the smallest power-of-two which is equal to or greater than the given integer. More...
 
int findHighestSetBit (uint32 n) noexcept
 Returns the index of the highest set bit in a (non-zero) number. More...
 
int countNumberOfBits (uint32 n) noexcept
 Returns the number of bits in a 32-bit integer. More...
 
int countNumberOfBits (uint64 n) noexcept
 Returns the number of bits in a 64-bit integer. More...
 
template<typename IntegerType >
IntegerType negativeAwareModulo (IntegerType dividend, const IntegerType divisor) noexcept
 Performs a modulo operation, but can cope with the dividend being negative. More...
 
template<typename NumericType >
NumericType square (NumericType n) noexcept
 Returns the square of its argument. More...
 
void writeLittleEndianBitsInBuffer (void *targetBuffer, uint32 startBit, uint32 numBits, uint32 value) noexcept
 Writes a number of bits into a memory buffer at a given bit index. More...
 
uint32 readLittleEndianBitsInBuffer (const void *sourceBuffer, uint32 startBit, uint32 numBits) noexcept
 Reads a number of bits from a buffer at a given bit index. More...
 

Variables

const double double_Pi = MathConstants<double>::pi
 A predefined value for Pi, at double-precision. More...
 
const float float_Pi = MathConstants<float>::pi
 A predefined value for Pi, at single-precision. More...
 
static const FloatType MathConstants< FloatType >::pi = static_cast<FloatType> (3.141592653589793238L)
 A predefined value for Pi. More...
 
static const FloatType MathConstants< FloatType >::euler = static_cast<FloatType> (2.71828182845904523536L)
 A predfined value for Euler's number. More...
 

Macro Definition Documentation

◆ JUCE_UNDENORMALISE

#define JUCE_UNDENORMALISE (   x)    { (x) += 0.1f; (x) -= 0.1f; }

This macro can be applied to a float variable to check whether it contains a denormalised value, and to normalise it if necessary.

On CPUs that aren't vulnerable to denormalisation problems, this will have no effect.

Referenced by Reverb::processMono().

Typedef Documentation

◆ int8

typedef signed char int8

A platform-independent 8-bit signed integer type.

◆ uint8

typedef unsigned char uint8

A platform-independent 8-bit unsigned integer type.

◆ int16

typedef signed short int16

A platform-independent 16-bit signed integer type.

◆ uint16

typedef unsigned short uint16

A platform-independent 16-bit unsigned integer type.

◆ int32

typedef signed int int32

A platform-independent 32-bit signed integer type.

◆ uint32

typedef unsigned int uint32

A platform-independent 32-bit unsigned integer type.

◆ int64

typedef long long int64

A platform-independent 64-bit integer type.

◆ uint64

typedef unsigned long long uint64

A platform-independent 64-bit unsigned integer type.

◆ pointer_sized_int

typedef int pointer_sized_int

A signed integer type that's guaranteed to be large enough to hold a pointer without truncating it.

◆ pointer_sized_uint

typedef unsigned int pointer_sized_uint

An unsigned integer type that's guaranteed to be large enough to hold a pointer without truncating it.

Function Documentation

◆ operator<<()

OutputStream& JUCE_CALLTYPE operator<< ( OutputStream stream,
const BigInteger value 
)

Writes a BigInteger to an OutputStream as a UTF8 decimal string.

◆ jmax() [1/3]

◆ jmax() [2/3]

template<typename Type >
Type jmax ( const Type  a,
const Type  b,
const Type  c 
)

Returns the larger of three values.

◆ jmax() [3/3]

template<typename Type >
Type jmax ( const Type  a,
const Type  b,
const Type  c,
const Type  d 
)

Returns the larger of four values.

References jmax().

◆ jmin() [1/3]

template<typename Type >
Type jmin ( const Type  a,
const Type  b 
)

Returns the smaller of two values.

Referenced by dsp::AudioBlock< float >::add(), dsp::AudioBlock< float >::addWithMultiply(), Rectangle< int >::constrainedWithin(), dsp::AudioBlock< float >::copy(), SelectedItemSet< SelectableItemType >::deselectAll(), Rectangle< int >::enlargeIfAdjacent(), Rectangle< int >::findAreaContainingPoints(), RectangleList< int >::getBounds(), AudioUnitHelpers::getBusCount(), Rectangle< int >::getIntersection(), Range< int64 >::getIntersectionWith(), Draggable3DOrientation::getQuaternion(), Rectangle< int >::getUnion(), Range< int64 >::getUnionWith(), Rectangle< int >::intersectRectangle(), Rectangle< int >::intersectRectangles(), jmin(), dsp::AudioBlock< float >::max(), dsp::AudioBlock< float >::min(), dsp::AudioBlock< float >::move(), dsp::AudioBlock< float >::multiply(), dsp::ProcessorDuplicator< MonoProcessorType, StateType >::process(), Rectangle< int >::removeFromBottom(), Rectangle< int >::removeFromLeft(), Rectangle< int >::removeFromRight(), Rectangle< int >::removeFromTop(), SparseSet< int >::removeRange(), dsp::AudioBlock< float >::replaceWithAbsoluteValueOf(), dsp::AudioBlock< float >::replaceWithNegativeOf(), ResizableBorderComponent::Zone::resizeRectangleBy(), SelectedItemSet< SelectableItemType >::selectOnly(), Rectangle< int >::setBottom(), Rectangle< int >::setRight(), AudioBuffer< float >::setSize(), dsp::AudioBlock< float >::subtract(), Rectangle< int >::transformedBy(), PixelARGB::unpremultiply(), Rectangle< int >::withBottom(), Range< int64 >::withEnd(), Rectangle< int >::withRight(), Line< ValueType >::withShortenedEnd(), Line< ValueType >::withShortenedStart(), BlocksProtocol::Packed7BitArrayBuilder< maxPacketBytes >::writeBits(), and littlefoot::Compiler::Statement::Visitor::~Visitor().

◆ jmin() [2/3]

template<typename Type >
Type jmin ( const Type  a,
const Type  b,
const Type  c 
)

Returns the smaller of three values.

◆ jmin() [3/3]

template<typename Type >
Type jmin ( const Type  a,
const Type  b,
const Type  c,
const Type  d 
)

Returns the smaller of four values.

References jmin().

◆ jmap() [1/2]

template<typename Type >
Type jmap ( Type  value0To1,
Type  targetRangeMin,
Type  targetRangeMax 
)

Remaps a normalised value (between 0 and 1) to a target range.

This effectively returns (targetRangeMin + value0To1 * (targetRangeMax - targetRangeMin)).

Referenced by dsp::LookupTable< NumericType >::getUnchecked().

◆ jmap() [2/2]

template<typename Type >
Type jmap ( Type  sourceValue,
Type  sourceRangeMin,
Type  sourceRangeMax,
Type  targetRangeMin,
Type  targetRangeMax 
)

Remaps a value from a source range to a target range.

References jassert.

◆ findMinimum()

template<typename Type >
Type findMinimum ( const Type *  data,
int  numValues 
)

Scans an array of values, returning the minimum value that it contains.

◆ findMaximum()

template<typename Type >
Type findMaximum ( const Type *  values,
int  numValues 
)

Scans an array of values, returning the maximum value that it contains.

◆ findMinAndMax()

template<typename Type >
void findMinAndMax ( const Type *  values,
int  numValues,
Type &  lowest,
Type &  highest 
)

Scans an array of values, returning the minimum and maximum values that it contains.

Referenced by AudioData::Pointer< SampleFormat, Endianness, InterleavingType, Constness >::findMinAndMax().

◆ jlimit()

template<typename Type >
Type jlimit ( Type  lowerLimit,
Type  upperLimit,
Type  valueToConstrain 
)
noexcept

Constrains a value to keep it within a given range.

This will check that the specified value lies between the lower and upper bounds specified, and if not, will return the nearest value that would be in-range. Effectively, it's like calling jmax (lowerLimit, jmin (upperLimit, value)).

Note that it expects that lowerLimit <= upperLimit. If this isn't true, the results will be unpredictable.

Parameters
lowerLimitthe minimum value to return
upperLimitthe maximum value to return
valueToConstrainthe value to try to return
Returns
the closest value to valueToConstrain which lies between lowerLimit and upperLimit (inclusive)
See also
jmin, jmax, jmap

References jassert.

Referenced by Range< int64 >::clipValue(), Rectangle< int >::constrainedWithin(), Range< int64 >::constrainRange(), Line< ValueType >::findNearestProportionalPositionTo(), BlocksProtocol::IntegerWithBitSize< 8 >::fromBipolarFloat(), BlocksProtocol::IntegerWithBitSize< 8 >::fromUnipolarFloat(), Rectangle< int >::getConstrainedPoint(), Draggable3DOrientation::getQuaternion(), dsp::LookupTableTransform< NumericType >::processSample(), ReferenceCountedArray< AudioProcessorGraph::Node >::removeRange(), OwnedArray< MidiBuffer >::removeRange(), Array< Component *>::removeRange(), and MidiEventList::toEventList().

◆ isPositiveAndBelow() [1/2]

template<typename Type1 , typename Type2 >
bool isPositiveAndBelow ( Type1  valueToTest,
Type2  upperLimit 
)
noexcept

Returns true if a value is at least zero, and also below a specified upper limit.

This is basically a quicker way to write:

valueToTest >= 0 && valueToTest < upperLimit

References jassert.

Referenced by AudioBuffer< float >::addFrom(), AudioBuffer< float >::addFromWithRamp(), AudioBuffer< float >::addSample(), AudioBuffer< float >::applyGain(), AudioBuffer< float >::applyGainRamp(), AudioBuffer< float >::clear(), AudioBuffer< float >::copyFrom(), AudioBuffer< float >::copyFromWithRamp(), AudioBuffer< float >::findMinMax(), MidiEventList::getEvent(), AudioBuffer< float >::getMagnitude(), AudioProcessor::BusesLayout::getNumChannels(), ReferenceCountedArray< AudioProcessorGraph::Node >::getObjectPointer(), ReferenceCountedArray< AudioProcessorGraph::Node >::getObjectPointerUnchecked(), SparseSet< int >::getRange(), AudioBuffer< float >::getReadPointer(), Array< Component *>::getReference(), AudioBuffer< float >::getRMSLevel(), AudioBuffer< float >::getSample(), dsp::LookupTable< NumericType >::getUnchecked(), OwnedArray< MidiBuffer >::getUnchecked(), Array< Component *>::getUnchecked(), AudioBuffer< float >::getWritePointer(), Array< Component *>::insert(), OwnedArray< MidiBuffer >::insertArray(), Array< Component *>::insertArray(), Array< Component *>::insertMultiple(), ReferenceCountedArray< AudioProcessorGraph::Node >::move(), OwnedArray< MidiBuffer >::move(), Array< Component *>::move(), OwnedArray< MidiBuffer >::operator[](), Array< Component *>::operator[](), dsp::LookupTableTransform< NumericType >::processSample(), ReferenceCountedArray< AudioProcessorGraph::Node >::remove(), OwnedArray< MidiBuffer >::remove(), Array< Component *>::remove(), ReferenceCountedArray< AudioProcessorGraph::Node >::removeAndReturn(), OwnedArray< MidiBuffer >::removeAndReturn(), Array< Component *>::removeAndReturn(), AudioBuffer< float >::reverse(), Array< Component *>::set(), AudioBuffer< float >::setSample(), Array< Component *>::setUnchecked(), ReferenceCountedArray< AudioProcessorGraph::Node >::swap(), OwnedArray< MidiBuffer >::swap(), and Array< Component *>::swap().

◆ isPositiveAndBelow() [2/2]

template<typename Type >
bool isPositiveAndBelow ( int  valueToTest,
Type  upperLimit 
)
noexcept

References jassert.

◆ isPositiveAndNotGreaterThan() [1/2]

template<typename Type1 , typename Type2 >
bool isPositiveAndNotGreaterThan ( Type1  valueToTest,
Type2  upperLimit 
)
noexcept

Returns true if a value is at least zero, and also less than or equal to a specified upper limit.

This is basically a quicker way to write:

valueToTest >= 0 && valueToTest <= upperLimit

References jassert.

◆ isPositiveAndNotGreaterThan() [2/2]

template<typename Type >
bool isPositiveAndNotGreaterThan ( int  valueToTest,
Type  upperLimit 
)
noexcept

References jassert.

◆ ignoreUnused() [1/4]

template<typename Type1 >
void ignoreUnused ( const Type1 &  )
noexcept

◆ ignoreUnused() [2/4]

template<typename Type1 , typename Type2 >
void ignoreUnused ( const Type1 &  ,
const Type2 &   
)
noexcept

◆ ignoreUnused() [3/4]

template<typename Type1 , typename Type2 , typename Type3 >
void ignoreUnused ( const Type1 &  ,
const Type2 &  ,
const Type3 &   
)
noexcept

◆ ignoreUnused() [4/4]

template<typename Type1 , typename Type2 , typename Type3 , typename Type4 >
void ignoreUnused ( const Type1 &  ,
const Type2 &  ,
const Type3 &  ,
const Type4 &   
)
noexcept

◆ numElementsInArray()

template<typename Type , int N>
int numElementsInArray ( Type(&)  array[N])

Handy function for getting the number of elements in a simple const C array.

E.g.

static int myArray[] = { 1, 2, 3 };
int numElements = numElementsInArray (myArray) // returns 3

References ignoreUnused().

Referenced by AudioBuffer< float >::AudioBuffer(), juce::CoreAudioLayouts::getSpeakerLayoutForCoreAudioTag(), AudioBuffer< float >::operator=(), AudioBuffer< float >::reverse(), and juce::CoreAudioLayouts::toCoreAudio().

◆ juce_hypot()

template<typename Type >
Type juce_hypot ( Type  a,
Type  b 
)
noexcept

Using juce_hypot is easier than dealing with the different types of hypot function that are provided by the various platforms and compilers.

Referenced by Point< int >::getDistanceFrom(), Point< int >::getDistanceFromOrigin(), and Line< ValueType >::getPointAlongLine().

◆ abs64()

int64 abs64 ( const int64  n)
noexcept

64-bit abs function.

References log().

◆ degreesToRadians() [1/2]

float degreesToRadians ( float  degrees)
noexcept

Converts an angle in degrees to radians.

◆ degreesToRadians() [2/2]

double degreesToRadians ( double  degrees)
noexcept

Converts an angle in degrees to radians.

◆ radiansToDegrees() [1/2]

float radiansToDegrees ( float  radians)
noexcept

Converts an angle in radians to degrees.

References float_Pi.

◆ radiansToDegrees() [2/2]

double radiansToDegrees ( double  radians)
noexcept

Converts an angle in radians to degrees.

References double_Pi.

◆ juce_isfinite() [1/3]

template<typename NumericType >
bool juce_isfinite ( NumericType  )
noexcept

The isfinite() method seems to vary between platforms, so this is a platform-independent function for it.

Referenced by StatisticsAccumulator< FloatType >::addValue(), Point< int >::isFinite(), and Rectangle< int >::isFinite().

◆ juce_isfinite() [2/3]

template<>
bool juce_isfinite ( float  value)
noexcept

◆ juce_isfinite() [3/3]

template<>
bool juce_isfinite ( double  value)
noexcept

◆ roundToInt() [1/2]

template<typename FloatType >
int roundToInt ( const FloatType  value)
noexcept

Fast floating-point-to-integer conversion.

This is faster than using the normal c++ cast to convert a float to an int, and it will round the value to the nearest integer, rather than rounding it down like the normal cast does.

Note that this routine gets its speed at the expense of some accuracy, and when rounding values whose floating point component is exactly 0.5, odd numbers and even numbers will be rounded up or down differently.

Referenced by AudioParameterInt::get(), AudioParameterChoice::getIndex(), roundDoubleToInt(), roundFloatToInt(), Point< int >::roundToInt(), roundToIntAccurate(), MidiEventList::toEventList(), and Rectangle< int >::toNearestInt().

◆ roundToInt() [2/2]

int roundToInt ( int  value)
noexcept

◆ roundToIntAccurate()

int roundToIntAccurate ( double  value)
noexcept

Fast floating-point-to-integer conversion.

This is a slightly slower and slightly more accurate version of roundDoubleToInt(). It works fine for values above zero, but negative numbers are rounded the wrong way.

References roundToInt().

◆ roundDoubleToInt()

int roundDoubleToInt ( double  value)
noexcept

Fast floating-point-to-integer conversion.

This is faster than using the normal c++ cast to convert a double to an int, and it will round the value to the nearest integer, rather than rounding it down like the normal cast does.

Note that this routine gets its speed at the expense of some accuracy, and when rounding values whose floating point component is exactly 0.5, odd numbers and even numbers will be rounded up or down differently. For a more accurate conversion, see roundDoubleToIntAccurate().

References roundToInt().

◆ roundFloatToInt()

int roundFloatToInt ( float  value)
noexcept

Fast floating-point-to-integer conversion.

This is faster than using the normal c++ cast to convert a float to an int, and it will round the value to the nearest integer, rather than rounding it down like the normal cast does.

Note that this routine gets its speed at the expense of some accuracy, and when rounding values whose floating point component is exactly 0.5, odd numbers and even numbers will be rounded up or down differently.

References roundToInt().

◆ truncatePositiveToUnsignedInt()

template<typename FloatType >
unsigned int truncatePositiveToUnsignedInt ( FloatType  value)
noexcept

Truncates a positive floating-point number to an unsigned int.

This is generally faster than static_cast<unsigned int> (std::floor (x)) but it only works for positive numbers small enough to be represented as an unsigned int.

References jassert, and max().

Referenced by dsp::LookupTable< NumericType >::getUnchecked().

◆ isPowerOfTwo()

template<typename IntegerType >
bool isPowerOfTwo ( IntegerType  value)

Returns true if the specified integer is a power-of-two.

◆ nextPowerOfTwo()

int nextPowerOfTwo ( int  n)
noexcept

Returns the smallest power-of-two which is equal to or greater than the given integer.

References findHighestSetBit().

◆ findHighestSetBit()

int findHighestSetBit ( uint32  n)
noexcept

Returns the index of the highest set bit in a (non-zero) number.

So for n=3 this would return 1, for n=7 it returns 2, etc. An input value of 0 is illegal!

Referenced by nextPowerOfTwo().

◆ countNumberOfBits() [1/2]

int countNumberOfBits ( uint32  n)
noexcept

Returns the number of bits in a 32-bit integer.

Referenced by countNumberOfBits().

◆ countNumberOfBits() [2/2]

int countNumberOfBits ( uint64  n)
noexcept

Returns the number of bits in a 64-bit integer.

References countNumberOfBits().

◆ negativeAwareModulo()

template<typename IntegerType >
IntegerType negativeAwareModulo ( IntegerType  dividend,
const IntegerType  divisor 
)
noexcept

Performs a modulo operation, but can cope with the dividend being negative.

The divisor must be greater than zero.

References jassert.

◆ square()

template<typename NumericType >
NumericType square ( NumericType  n)
noexcept

Returns the square of its argument.

References readLittleEndianBitsInBuffer(), and writeLittleEndianBitsInBuffer().

◆ writeLittleEndianBitsInBuffer()

void writeLittleEndianBitsInBuffer ( void *  targetBuffer,
uint32  startBit,
uint32  numBits,
uint32  value 
)
noexcept

Writes a number of bits into a memory buffer at a given bit index.

The buffer is treated as a sequence of 8-bit bytes, and the value is encoded in little-endian order, so for example if startBit = 10, and numBits = 11 then the lower 6 bits of the value would be written into bits 2-8 of targetBuffer[1], and the upper 5 bits of value into bits 0-5 of targetBuffer[2].

See also
readLittleEndianBitsInBuffer

Referenced by littlefoot::LittleFootRemoteHeap< ImplementationClass >::setBits(), and square().

◆ readLittleEndianBitsInBuffer()

uint32 readLittleEndianBitsInBuffer ( const void *  sourceBuffer,
uint32  startBit,
uint32  numBits 
)
noexcept

Reads a number of bits from a buffer at a given bit index.

The buffer is treated as a sequence of 8-bit bytes, and the value is encoded in little-endian order, so for example if startBit = 10, and numBits = 11 then the lower 6 bits of the result would be read from bits 2-8 of sourceBuffer[1], and the upper 5 bits of the result from bits 0-5 of sourceBuffer[2].

See also
writeLittleEndianBitsInBuffer

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getHeapBits(), littlefoot::LittleFootRemoteHeap< ImplementationClass >::setBits(), and square().

Variable Documentation

◆ double_Pi

◆ float_Pi

const float float_Pi = MathConstants<float>::pi

A predefined value for Pi, at single-precision.

See also
double_Pi

Referenced by radiansToDegrees().

◆ pi

template<typename FloatType >
const FloatType MathConstants< FloatType >::pi = static_cast<FloatType> (3.141592653589793238L)
static

A predefined value for Pi.

◆ euler

template<typename FloatType >
const FloatType MathConstants< FloatType >::euler = static_cast<FloatType> (2.71828182845904523536L)
static

A predfined value for Euler's number.