     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85

    //! Implements portable horizontal arithmetic reductions.
    #![allow(unused)]

    macro_rules! impl_minmax_reductions {
        ($id:ident, $elem_ty:ident) => {
            impl $id {
                /// Largest vector element value.
                #[cfg(not(any(target_arch = "aarch64", target_arch = "arm")))]
                #[inline]
                pub fn max_element(self) -> $elem_ty {
                    use coresimd::simd_llvm::simd_reduce_max;
                    unsafe { simd_reduce_max(self) }
                }

                /// Largest vector element value.
                #[cfg(any(target_arch = "aarch64", target_arch = "arm"))]
                #[allow(unused_imports)]
                #[inline]
                pub fn max_element(self) -> $elem_ty {
                    // FIXME: broken on AArch64
                    // https://bugs.llvm.org/show_bug.cgi?id=36796
                    use cmp::Ord;
                    let mut x = self.extract(0);
                    for i in 1..$id::lanes() {
                        x = x.max(self.extract(i));
                    }
                    x
                }

                /// Smallest vector element value.
                #[cfg(not(any(target_arch = "aarch64", target_arch = "arm")))]
                #[inline]
                pub fn min_element(self) -> $elem_ty {
                    use coresimd::simd_llvm::simd_reduce_min;
                    unsafe { simd_reduce_min(self) }
                }

                /// Smallest vector element value.
                #[cfg(any(target_arch = "aarch64", target_arch = "arm"))]
                #[allow(unused_imports)]
                #[inline]
                pub fn min_element(self) -> $elem_ty {
                    // FIXME: broken on AArch64
                    // https://bugs.llvm.org/show_bug.cgi?id=36796
                    use cmp::Ord;
                    let mut x = self.extract(0);
                    for i in 1..$id::lanes() {
                        x = x.min(self.extract(i));
                    }
                    x
                }
            }
        };
    }

    #[cfg(test)]
    macro_rules! test_minmax_reductions {
        ($id:ident, $elem_ty:ident) => {
            #[test]
            fn max_element() {
                use coresimd::simd::$id;
                let v = $id::splat(0 as $elem_ty);
                assert_eq!(v.max_element(), 0 as $elem_ty);
                let v = v.replace(1, 1 as $elem_ty);
                assert_eq!(v.max_element(), 1 as $elem_ty);
                let v = v.replace(0, 2 as $elem_ty);
                assert_eq!(v.max_element(), 2 as $elem_ty);
            }

            #[test]
            fn min_element() {
                use coresimd::simd::$id;
                let v = $id::splat(0 as $elem_ty);
                assert_eq!(v.min_element(), 0 as $elem_ty);
                let v = v.replace(1, 1 as $elem_ty);
                assert_eq!(v.min_element(), 0 as $elem_ty);
                let v = $id::splat(1 as $elem_ty);
                let v = v.replace(0, 2 as $elem_ty);
                assert_eq!(v.min_element(), 1 as $elem_ty);
                let v = $id::splat(2 as $elem_ty);
                let v = v.replace(1, 1 as $elem_ty);
                assert_eq!(v.min_element(), 1 as $elem_ty);
            }
        };
    }

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)