Return an iterator over the possibly contained value

Return a mutable iterator over the possibly contained value

Return a consuming iterator over the possibly contained value

Returns true if the option equals None

Returns true if the option contains a Some value

Returns None if the option is None, otherwise returns optb.

Returns None if the option is None, otherwise calls f with the wrapped value and returns the result.

Returns None if the option is None, otherwise calls f with a reference to the wrapped value and returns the result.

Returns None if the option is None, otherwise calls f with a mutable reference to the wrapped value and returns the result.

Returns the option if it contains a value, otherwise returns optb.

Returns the option if it contains a value, otherwise calls f and returns the result.

Filters an optional value using given function.

Maps a Some value from one type to another by reference

Maps a Some value from one type to another by a mutable reference

Applies a function to the contained value or returns a default

Maps a Some value from one type to another by a mutable reference, or returns a default value.

As map, but consumes the option and gives f ownership to avoid copying.

As map_default, but consumes the option and gives f ownership to avoid copying.

Take the value out of the option, leaving a None in its place.

Apply a function to the contained value or do nothing. Returns true if the contained value was mutated.

Apply a function to the contained value or set it to a default. Returns true if the contained value was mutated, or false if set to the default.

Gets an immutable reference to the value inside an option.

Failure

Fails if the value equals None

Safety note

In general, because this function may fail, its use is discouraged (calling get on None is akin to dereferencing a null pointer). Instead, prefer to use pattern matching and handle the None case explicitly.

Gets a mutable reference to the value inside an option.

Failure

Fails if the value equals None

Safety note

In general, because this function may fail, its use is discouraged (calling get on None is akin to dereferencing a null pointer). Instead, prefer to use pattern matching and handle the None case explicitly.

Moves a value out of an option type and returns it.

Useful primarily for getting strings, vectors and unique pointers out of option types without copying them.

Failure

Fails if the value equals None.

Safety note

In general, because this function may fail, its use is discouraged. Instead, prefer to use pattern matching and handle the None case explicitly.

The option dance. Moves a value out of an option type and returns it, replacing the original with None.

Failure

Fails if the value equals None.

Gets the value out of an option, printing a specified message on failure

Failure

Fails if the value equals None

Returns the contained value or a default

Returns the contained value or computes it from a closure

Applies a function zero or more times until the result is None.

Returns the contained value or default (for this type)

Returns the contained value or zero (for this type)

Call the provided callback f one or more times with byte-slices that should be used when computing a hash value or otherwise "flattening" the structure into a sequence of bytes. The lsb0 parameter conveys whether the caller is asking for little-endian bytes (true) or big-endian (false); this should only be relevant in implementations that represent a single multi-byte datum such as a 32 bit integer or 64 bit floating-point value. It can be safely ignored for larger structured types as they are usually processed left-to-right in declaration order, regardless of underlying memory endianness.

Returns a copy of the value. The contents of owned pointers are copied to maintain uniqueness, while the contents of managed pointers are not copied.

Return a deep copy of the value. Unlike Clone, the contents of shared pointer types are copied.

Converts the value of self to an owned string

Convert to the option type

Convert to the option type

Convert to the option type

Convert to the result type

Convert to the result type

Convert to the either type

Convert to the either type

Return the "default value" for a type.

Generates a random instance of this type using the specified source of randomness

Write the given buffer

Failure

Raises the io_error condition on error

Flush output

Read bytes, up to the length of buf and place them in buf. Returns the number of bytes read. The number of bytes read my be less than the number requested, even 0. Returns None on EOF.

Failure

Raises the read_error condition on error. If the condition is handled then no guarantee is made about the number of bytes read and the contents of buf. If the condition is handled returns None (XXX see below).

XXX

• Should raise_default error on eof?
• If the condition is handled it should still return the bytes read, in which case there's no need to return Option - but then you have to install a handler to detect eof.

This doesn't take a len argument like the old read. Will people often need to slice their vectors to call this and will that be annoying? Is it actually possible for 0 bytes to be read successfully?

Return whether the Reader has reached the end of the stream.

Example

let reader = FileStream::new()
while !reader.eof() {
    println(reader.read_line());
}

Failure

Returns true on failure.

Spin up the listener and start queueing incoming connections

Failure

Raises io_error condition. If the condition is handled, then listen returns None.

Wait for and accept an incoming connection

Failure

Raise io_error condition. If the condition is handled, then accept returns None.