Bug: 148898578

Clone this repo:
  1. 908fa57 [automerger skipped] Mark ab/7061308 as merged in stage. am: 757c347bd9 -s ours am: 9e8ff3c207 -s ours by Xin Li · 11 months ago android-games-sdk-release android-s-v2-preview-1 android12--mainline-release android12-dev android12-qpr1-d-release android12-qpr1-d-s1-release android12-qpr1-d-s2-release android12-qpr1-d-s3-release android12-qpr1-release master android-12.0.0_r16 android-12.0.0_r18 android-12.0.0_r19 android-12.0.0_r20 android-12.0.0_r21 android-12.0.0_r26 android-12.0.0_r27 android-mainline-12.0.0_r4 android-s-v2-beta-2 android-s-v2-preview-2
  2. 9e8ff3c [automerger skipped] Mark ab/7061308 as merged in stage. am: 757c347bd9 -s ours by Xin Li · 11 months ago
  3. 757c347 Mark ab/7061308 as merged in stage. by Xin Li · 11 months ago android-s-beta-4 android-s-beta-5 android-s-beta-1 android-s-beta-2 android-s-beta-3
  4. e9e554d [LSC] Add LOCAL_LICENSE_KINDS to external/FXdiv am: eb48e27204 am: 59a9ff3c6f am: a18bac0a26 by Bob Badour · 11 months ago
  5. a18bac0 [LSC] Add LOCAL_LICENSE_KINDS to external/FXdiv am: eb48e27204 am: 59a9ff3c6f by Bob Badour · 11 months ago

FXdiv

MIT License Build Status

Header-only library for division via fixed-point multiplication by inverse

On modern CPUs and GPUs integer division is several times slower than multiplication. FXdiv implements an algorithm to replace an integer division with a multiplication and two shifts. This algorithm improves performance when an application performs repeated divisions by the same divisor.

Features

  • Integer division for uint32_t, uint64_t, and size_t
  • Header-only library, no installation or build required
  • Compatible with C99, C++, OpenCL, and CUDA
  • Uses platform-specific compiler intrinsics for optimal performance
  • Covered with unit tests and microbenchmarks

Example

#include <fxdiv.h>

/* Division of array by a constant: reference implementation */
void divide_array_c(size_t length, uint32_t array[], uint32_t divisor) {
  for (size_t i = 0; i < length; i++) {
    array[i] /= divisor;
  }
}

/* Division of array by a constant: implementation with FXdiv */
void divide_array_fxdiv(size_t length, uint32_t array[], uint32_t divisor) {
  const struct fxdiv_divisor_uint32_t precomputed_divisor =
    fxdiv_init_uint32_t(divisor);
  for (size_t i = 0; i < length; i++) {
    array[i] = fxdiv_quotient_uint32_t(array[i], precomputed_divisor);
  }
}

Status

Currently working features:

Platformuint32_tuint64_tsize_t
x86-64 gccWorksWorksWorks
x86-64 clangWorksWorksWorks
x86-64 MSVCWorksWorksWorks
x86 gccWorksWorksWorks
x86 clangWorksWorksWorks
x86 MSVCWorksWorksWorks
ARMv7 gccWorksWorksWorks
ARMv7 clangWorksWorksWorks
ARMv7 MSVC*CompilesCompilesCompiles
ARM64 gccWorksWorksWorks
ARM64 clangWorksWorksWorks
ARM64 MSVC*CompilesCompilesCompiles
PPC64 gccWorksWorksWorks
WAsm clangWorksWorksWorks
Asm.js clangWorksWorksWorks
PNaCl clangWorksWorksWorks
CUDAUntestedUntestedUntested
OpenCLUntestedUntestedUntested

*ARMv7 and ARM64 builds with MSVC are presumed to work, but were only verified to compile successfully

References

  • Granlund, Torbjörn, and Peter L. Montgomery. “Division by invariant integers using multiplication.” In ACM SIGPLAN Notices, vol. 29, no. 6, pp. 61-72. ACM, 1994. Available: gmplib.org/~tege/divcnst-pldi94.pdf