---
name: "al_ftofix"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_ftofix/3alleg5"
---

# al\_ftofix(3alleg5)

Allegro 5 API

## NAME

al\_ftofix - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro.h>
  al_fixed al_ftofix(double x);
  ```

## DESCRIPTION

Converts a floating point value to fixed point. Unlike al\_itofix(3alleg5), this function clamps values which could overflow the type conversion, setting Allegro’s errno to ERANGE in the process if this happens.

Example:

-

  ```
  al_fixed number;
  number = al_itofix(-40000);
  assert(al_fixfloor(number) == -32768);
  number = al_itofix(64000);
  assert(al_fixfloor(number) == 32767);
  assert(!al_get_errno()); /* This will fail. */
  ```

## RETURN VALUE

Returns the value of the floating point value converted to fixed point clamping overflows (and setting Allegro’s errno).

## SEE ALSO

al\_fixtof(3alleg5), al\_itofix(3alleg5), al\_fixtoi(3alleg5), al\_get\_errno(3alleg5)
