Skip to content

simdDiv ​

simdDiv divide os elementos correspondentes e retorna um novo array em Result<T[], SimdError>.

AssinaturasimdDiv<T>(left: T[], right: T[]): Result<T[], SimdError>
tyrus
import { simdDiv, SimdError } from "tyrus:simd";

const left: i32[] = [100, 81, 72, 55, 42];
const right: i32[] = [10, 9, 8, 5, 6];
const result: Result<i32[], SimdError> = simdDiv(left, right);

match (result) {
    Ok(values) => {
        print(values); // [10, 9, 9, 11, 7]
    }
    Err(error) => {
        printError(error.code, error.message);
    }
}

Floating-point division follows IEEE behavior. Dividing nonzero values by 0.0 produces infinity, and 0.0 / 0.0 produces NaN; these results are returned in Ok.

A divisão inteira trunca em direção a zero. Se qualquer lane inteira tiver divisor zero, o resultado será ERR_SIMD_DIVISION_BY_ZERO. O mínimo signed dividido por -1 retorna ERR_SIMD_INTEGER_OVERFLOW, pois o quociente exato não cabe no tipo da lane. A operação verifica todas as lanes inteiras antes da divisão, então nenhuma lane inválida chega a uma divisão inteira. A divisão de ponto flutuante segue IEEE e retorna infinito ou NaN em Ok quando apropriado. Diferenças de tamanho dinâmico e falhas de alocação do resultado também retornam SimdError. Arrays de tamanho fixo podem ser passados diretamente; comprimentos fixos diferentes são rejeitados com E0308 em compilação.

Divisão de ponto flutuante por zero ​

A divisão de ponto flutuante por zero segue IEEE 754 e retorna estes valores em Ok: 1.0 / 0.0 produz Infinity, -1.0 / 0.0 produz -Infinity e 0.0 / 0.0 produz NaN.

tyrus
import { simdDiv, SimdError } from "tyrus:simd";

const main = (): void => {
    const numerators: f32[] = [1.0, -1.0, 0.0];
    const denominators: f32[] = [0.0; 3];
    const result: Result<f32[], SimdError> = simdDiv(numerators, denominators);

    match (result) {
        Ok(values) => {
            print(values); // [Infinity, -Infinity, NaN]
        }
        Err(error) => {
            printError(error.code, error.message);
        }
    }
};

Erros ​

error

Um divisor inteiro igual a zero retorna um erro recuperável:

tyrus
import { simdDiv, SimdError } from "tyrus:simd";

const left: i32[] = [100, 81, 72, 55];
const right: i32[] = [10, 0, 8, 5];
const result: Result<i32[], SimdError> = simdDiv(left, right);

match (result) {
    Ok(values) => { print(values); }
    Err(error) => { printError(error.code, error.message); }
}
text
ERR_SIMD_DIVISION_BY_ZERO simdDiv cannot divide an integer lane by zero

error

O mínimo signed dividido por -1 também retorna um erro recuperável:

tyrus
import { simdDiv, SimdError } from "tyrus:simd";

const left: i8[] = [-128; 1];
const right: i8[] = [-1; 1];
const result: Result<i8[], SimdError> = simdDiv(left, right);

match (result) {
    Ok(values) => { print(values); }
    Err(error) => { printError(error.code, error.message); }
}
text
ERR_SIMD_INTEGER_OVERFLOW simdDiv cannot represent the signed minimum divided by -1