:orphan:
# PetscUnlikely
Hints the compiler that the given condition is usually false 
## Synopsis
```
#include <petscmacros.h>
bool PetscUnlikely(bool cond)
```
Not Collective; No Fortran Support


## Input Parameter

- ***cond -*** Boolean expression





## Notes
This returns the same truth value, it is only a hint to compilers that the result of cond is
unlikely to be true.


## Example usage
```none
  if (PetscUnlikely(cond)) {
    foo(); // cold path
  } else {
    bar(); // hot path
  }
```



## See Also
 `PetscLikely()`, `PetscUnlikelyDebug()`, `PetscCall()`, `PetscDefined()`, `PetscHasAttribute()`,
`PETSC_ATTRIBUTE_COLD`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/include/petscmacros.h.html#PetscUnlikely">include/petscmacros.h</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/include/petscmacros.h)


[Index of all Sys routines](index.md)  
[Table of Contents for all manual pages](/manualpages/index.md)  
[Index of all manual pages](/manualpages/singleindex.md)  
