StreamUtil (Stream Utility 1.12 API)

java.lang.Object
- org.jmmo.util.StreamUtil

```
public class StreamUtil
extends Object
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface StreamUtil.ThrowableRunnable
Runnable that throw some exception

Nested Classes
Modifier and Type	Class and Description
`static interface`	`StreamUtil.ThrowableRunnable` Runnable that throw some exception

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Stream<Throwable>`	`causes(Throwable throwable)`
`static Stream<Path>`	`directories(Path directory)` Finds directories within a given directory and its subdirectories.
`static Stream<Path>`	`directories(Path directory, DirectoryStream.Filter<Path> filter)` Finds directories within a given directory and its subdirectories.
`static Stream<Path>`	`directories(Path directory, String glob)` Finds directories within a given directory and its subdirectories.
`static Stream<Path>`	`directoriesAndFiles(Path directory)` Finds directories within a given directory and its subdirectories.
`static Stream<Path>`	`directoriesAndFiles(Path directory, DirectoryStream.Filter<Path> filter)` Finds directories and files within a given directory and its subdirectories.
`static Stream<Path>`	`directoriesAndFiles(Path directory, String glob)` Finds directories and files within a given directory and its subdirectories.
`static Stream<Path>`	`files(Path directory)` Finds files within a given directory and its subdirectories.
`static Stream<Path>`	`files(Path directory, DirectoryStream.Filter<Path> filter)` Finds files within a given directory and its subdirectories.
`static Stream<Path>`	`files(Path directory, String glob)` Finds files within a given directory and its subdirectories.
`static <T> Stream<T>`	`fromIterator(Iterator<T> iterator)`
`static <T> Stream<T>`	`fromIterator(Iterator<T> iterator, int characteristics)`
`static <T> Iterator<T>`	`iteratorFilter(Iterator<T> iterator, Predicate<? super T> predicate)` Returns an iterator consisting of the elements of this stream that match the given predicate.
`static <T,R> Iterator<R>`	`iteratorFlatMap(Iterator<T> iterator, Function<? super T,? extends Iterator<? extends R>> mapper)` Returns an iterator consisting of the results of replacing each element of this iterator with the contents of a mapped iterator produced by applying the provided mapping function to each element.
`static <T,R> Iterator<R>`	`iteratorMap(Iterator<T> iterator, Function<? super T,? extends R> mapper)` Returns an iterator consisting of the results of applying the given function to the elements of this iterator.
`static Stream<String>`	`matchGroups(Matcher matcher)`
`static Stream<String>`	`matchGroups(Matcher matcher, int group)`
`static Stream<MatchResult>`	`matchResults(Matcher matcher)`
`static <T> Stream<T>`	`nullable(T value)`
`static <T> Stream<T>`	`optional(Optional<T> optional)`
`static <T> T`	`resultNull(Runnable runnable)` Executes runnable then return null of required type
`static <T> void`	`resultVoid(Supplier<T> supplier)` Executes something that returns result and ignore result
`static <R,T extends Throwable> R`	`sneakyThrow(Throwable ex)` Throws checked exceptions like unchecked ones
`static <T> Stream<T>`	`supply(Supplier<T> supplier)`
`static <R> R`	`unchecked(Callable<R> callable)` Prevent necessity to check exceptions from lambdas that return some result
`static void`	`unchecked(StreamUtil.ThrowableRunnable runnable)` Prevent necessity to check exceptions from lambdas that don't return any result
`static <T> T`	`uncheckedNull(StreamUtil.ThrowableRunnable runnable)` Prevent necessity to check exceptions from lambdas that don't return any result, then return null of required type
`static <R> void`	`uncheckedVoid(Callable<R> callable)` Prevent necessity to check exceptions from lambdas that return some result and ignore result

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - optional
```
public static <T> Stream<T> optional(Optional<T> optional)
```
  - nullable
```
public static <T> Stream<T> nullable(T value)
```
  - fromIterator
```
public static <T> Stream<T> fromIterator(Iterator<T> iterator)
```
  - fromIterator
```
public static <T> Stream<T> fromIterator(Iterator<T> iterator,
                                         int characteristics)
```
  - supply
```
public static <T> Stream<T> supply(Supplier<T> supplier)
```
  - matchResults
```
public static Stream<MatchResult> matchResults(Matcher matcher)
```
  - matchGroups
```
public static Stream<String> matchGroups(Matcher matcher)
```
  - matchGroups
```
public static Stream<String> matchGroups(Matcher matcher,
                                         int group)
```
  - causes
```
public static Stream<Throwable> causes(Throwable throwable)
```
  - files
```
public static Stream<Path> files(Path directory)
```
    Finds files within a given directory and its subdirectories.
  - files
```
public static Stream<Path> files(Path directory,
                                 String glob)
```
    Finds files within a given directory and its subdirectories. The files are filtered by matching the String representation of their file names against the given globbing pattern.
  - files
```
public static Stream<Path> files(Path directory,
                                 DirectoryStream.Filter<Path> filter)
```
    Finds files within a given directory and its subdirectories. The files are filtered by the given filter
  - directories
```
public static Stream<Path> directories(Path directory)
```
    Finds directories within a given directory and its subdirectories.
  - directories
```
public static Stream<Path> directories(Path directory,
                                       String glob)
```
    Finds directories within a given directory and its subdirectories. The files are filtered by matching the String representation of their file names against the given globbing pattern.
  - directories
```
public static Stream<Path> directories(Path directory,
                                       DirectoryStream.Filter<Path> filter)
```
    Finds directories within a given directory and its subdirectories. The files are filtered by the given filter
  - directoriesAndFiles
```
public static Stream<Path> directoriesAndFiles(Path directory)
```
    Finds directories within a given directory and its subdirectories.
  - directoriesAndFiles
```
public static Stream<Path> directoriesAndFiles(Path directory,
                                               String glob)
```
    Finds directories and files within a given directory and its subdirectories. The files are filtered by matching the String representation of their file names against the given globbing pattern.
  - directoriesAndFiles
```
public static Stream<Path> directoriesAndFiles(Path directory,
                                               DirectoryStream.Filter<Path> filter)
```
    Finds directories and files within a given directory and its subdirectories. The files are filtered by the given filter
  - sneakyThrow
```
public static <R,T extends Throwable> R sneakyThrow(Throwable ex)
                                             throws T extends Throwable
```
    Throws checked exceptions like unchecked ones
    
    Type Parameters:
    
    R - fake result type
    
    T - exception type
    
    Parameters:
    
    ex - any exception
    
    Returns:
    
    never returns
    
    Throws:
    
    T
    
    T extends Throwable
  - unchecked
```
public static <R> R unchecked(Callable<R> callable)
```
    Prevent necessity to check exceptions from lambdas that return some result
    
    Type Parameters:
    
    R - result type
    
    Parameters:
    
    callable - some lambda throwing checked exception
    
    Returns:
    
    lambda result
  - unchecked
```
public static void unchecked(StreamUtil.ThrowableRunnable runnable)
```
    Prevent necessity to check exceptions from lambdas that don't return any result
    
    Parameters:
    
    runnable - some lambda throwing checked exception
  - uncheckedNull
```
public static <T> T uncheckedNull(StreamUtil.ThrowableRunnable runnable)
```
    Prevent necessity to check exceptions from lambdas that don't return any result, then return null of required type
    
    Type Parameters:
    
    T - return value type
    
    Parameters:
    
    runnable - some lambda throwing checked exception
    
    Returns:
    
    null value of T type
  - uncheckedVoid
```
public static <R> void uncheckedVoid(Callable<R> callable)
```
    Prevent necessity to check exceptions from lambdas that return some result and ignore result
    
    Type Parameters:
    
    R - ignored result type
    
    Parameters:
    
    callable - some lambda throwing checked exception
  - resultNull
```
public static <T> T resultNull(Runnable runnable)
```
    Executes runnable then return null of required type
    
    Type Parameters:
    
    T - return value type
    
    Parameters:
    
    runnable - some code
    
    Returns:
    
    null value of T type
  - resultVoid
```
public static <T> void resultVoid(Supplier<T> supplier)
```
    Executes something that returns result and ignore result
    
    Type Parameters:
    
    T - ignored result type
    
    Parameters:
    
    supplier - Something that returns result
  - iteratorMap
```
public static <T,R> Iterator<R> iteratorMap(Iterator<T> iterator,
                                            Function<? super T,? extends R> mapper)
```
    Returns an iterator consisting of the results of applying the given function to the elements of this iterator.
    
    Parameters:
    
    iterator - source iterator
    
    mapper - function to apply to each element
    
    Returns:
    
    new iterator
  - iteratorFilter
```
public static <T> Iterator<T> iteratorFilter(Iterator<T> iterator,
                                             Predicate<? super T> predicate)
```
    Returns an iterator consisting of the elements of this stream that match the given predicate.
    
    Parameters:
    
    iterator - source iterator
    
    predicate - predicate to apply to each element to determine if it should be included
    
    Returns:
    
    new iterator
  - iteratorFlatMap
```
public static <T,R> Iterator<R> iteratorFlatMap(Iterator<T> iterator,
                                                Function<? super T,? extends Iterator<? extends R>> mapper)
```
    Returns an iterator consisting of the results of replacing each element of this iterator with the contents of a mapped iterator produced by applying the provided mapping function to each element.
    
    Parameters:
    
    iterator - source iterator
    
    mapper - function to apply to each element
    
    Returns:
    
    new iterator

Class StreamUtil

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

optional

nullable

fromIterator

fromIterator

supply

matchResults

matchGroups

matchGroups

causes

files

files

files

directories

directories

directories

directoriesAndFiles

directoriesAndFiles

directoriesAndFiles

sneakyThrow

unchecked

unchecked

uncheckedNull

uncheckedVoid

resultNull

resultVoid

iteratorMap

iteratorFilter

iteratorFlatMap