# Setting the coordinates of a three-dimensional vector

[Русская версия / Russian version](set-values-rus.md)

The function for **BGC_FP32_Vector3**:

```c
inline void bgc_fp32_vector3_set_values(BGC_FP32_Vector3* const destination, const float x, const float y, const float z);
```

The function for **BGC_FP64_Vector3**:

```c
inline void bgc_fp64_vector3_set_values(BGC_FP64_Vector3* const destination, const double x, const double y, const double z);
```

These functions allow to set the values of coordinates in one-line.

The functions are especially useful when the values are constants like in the example below.

Each of these functions is equivalent to the following lines of code:

```c
destination->x = x;
destination->y = y;
destination->z = z;
```

### Parameters

|  Parameter  | Direction | Description                                             |
| ----------- | --------- | ------------------------------------------------------- |
| destination |     out   | A pointer to a 3D-vector, which coordinates must be set |
|      x      |     in    | A new value for the X-coordinate                        |
|      y      |     in    | A new value for the Y-coordinate                        |
|      z      |     in    | A new value for the Z-coordinate                        |

The *destination* parameter must be a valid pointer. The NULL (0) value is considered invalid.

### Example

```c
#include <stdio.h>
#include <basic-geometry.h>

int main()
{
    BGC_FP32_Vector3 v;

    bgc_fp32_vector3_set_values(&v, -2.2f, 7.8f, 10.01f);

    printf("x = %f, y = %f, z = %f\n", v.x, v.y, v.z);

    return 0;
}
```

[Documentation](../intro-eng.md) / [3D vectors](../vector3-eng.md)