Module io

Variants

• Append

• Create

• Truncate

• NoFlag

Examples

None right now.

Variants

• SeekSet

• SeekEnd

• SeekCur

Variants

• Screen

• File

Examples

None right now.

Method read

fn read(&self, bytes: &mut [u8], len: uint) -> uint

Reads bytes and puts them into bytes, advancing the cursor. Returns the number of bytes read.

The number of bytes to be read is len or the end of the file, whichever comes first.

The buffer must be at least len bytes long.

read is conceptually similar to C's fread function.

Method read_byte

fn read_byte(&self) -> int

Reads a single byte, advancing the cursor.

In the case of an EOF or an error, returns a negative value.

read_byte is conceptually similar to C's getc function.

Method eof

fn eof(&self) -> bool

Returns a boolean value: are we currently at EOF?

Note that stream position may be already at the end-of-file point, but eof returns false until an attempt to read at that position.

eof is conceptually similar to C's feof function.

Method seek

fn seek(&self, position: int, style: SeekStyle)

Seek to a given position in the stream.

Takes an optional SeekStyle, which affects how we seek from the position. See SeekStyle docs for more details.

seek is conceptually similar to C's fseek function.

Method tell

fn tell(&self) -> uint

Returns the current position within the stream.

tell is conceptually similar to C's ftell function.

Examples:

None right now.

Method read_bytes

fn read_bytes(&self, len: uint) -> ~[u8]

Reads len number of bytes, and gives you a new vector back.

Method read_until

fn read_until(&self, c: u8, include: bool) -> ~str

Reads up until a specific byte is seen or EOF.

The include parameter specifies if the character should be included in the returned string.

Method read_line

fn read_line(&self) -> ~str

Reads up until the first '\n' or EOF.

The '\n' is not included in the result.

Method read_chars

fn read_chars(&self, n: uint) -> ~[char]

Reads n chars.

Assumes that those chars are UTF-8 encoded.

The '\n' is not included in the result.

Method read_char

fn read_char(&self) -> char

Reads a single UTF-8 encoded char.

Method read_c_str

fn read_c_str(&self) -> ~str

Reads up until the first null byte or EOF.

The null byte is not returned.

Method read_whole_stream

fn read_whole_stream(&self) -> ~[u8]

Reads all remaining data in the stream.

Method each_byte

fn each_byte(&self, it: &fn(int) -> bool) -> bool

Iterate over every byte until EOF or the iterator breaks.

Method each_char

fn each_char(&self, it: &fn(char) -> bool) -> bool

Iterate over every char until EOF or the iterator breaks.

Method each_line

fn each_line(&self, it: &fn(&str) -> bool) -> bool

Iterate over every line until EOF or the iterator breaks.

Method read_lines

fn read_lines(&self) -> ~[~str]

Reads all of the lines in the stream.

Returns a vector of those lines.

Method read_le_uint_n

fn read_le_uint_n(&self, nbytes: uint) -> u64

Reads n little-endian unsigned integer bytes.

n must be between 1 and 8, inclusive.

Method read_le_int_n

fn read_le_int_n(&self, nbytes: uint) -> i64

Reads n little-endian signed integer bytes.

n must be between 1 and 8, inclusive.

Method read_be_uint_n

fn read_be_uint_n(&self, nbytes: uint) -> u64

Reads n big-endian unsigned integer bytes.

n must be between 1 and 8, inclusive.

Method read_be_int_n

fn read_be_int_n(&self, nbytes: uint) -> i64

Reads n big-endian signed integer bytes.

n must be between 1 and 8, inclusive.

Method read_le_uint

fn read_le_uint(&self) -> uint

Reads a little-endian unsigned integer.

The number of bytes returned is system-dependant.

Method read_le_int

fn read_le_int(&self) -> int

Reads a little-endian integer.

The number of bytes returned is system-dependant.

Method read_be_uint

fn read_be_uint(&self) -> uint

Reads a big-endian unsigned integer.

The number of bytes returned is system-dependant.

Method read_be_int

fn read_be_int(&self) -> int

Reads a big-endian integer.

The number of bytes returned is system-dependant.

Method read_be_u64

fn read_be_u64(&self) -> u64

Reads a big-endian u64.

u64s are 8 bytes long.

Method read_be_u32

fn read_be_u32(&self) -> u32

Reads a big-endian u32.

u32s are 4 bytes long.

Method read_be_u16

fn read_be_u16(&self) -> u16

Reads a big-endian u16.

u16s are 2 bytes long.

Method read_be_i64

fn read_be_i64(&self) -> i64

Reads a big-endian i64.

i64s are 8 bytes long.

Method read_be_i32

fn read_be_i32(&self) -> i32

Reads a big-endian i32.

i32s are 4 bytes long.

Method read_be_i16

fn read_be_i16(&self) -> i16

Reads a big-endian i16.

i16s are 2 bytes long.

Method read_be_f64

fn read_be_f64(&self) -> f64

Reads a big-endian f64.

f64s are 8 byte, IEEE754 double-precision floating point numbers.

Method read_be_f32

fn read_be_f32(&self) -> f32

Reads a big-endian f32.

f32s are 4 byte, IEEE754 single-precision floating point numbers.

Method read_le_u64

fn read_le_u64(&self) -> u64

Reads a little-endian u64.

u64s are 8 bytes long.

Method read_le_u32

fn read_le_u32(&self) -> u32

Reads a little-endian u32.

u32s are 4 bytes long.

Method read_le_u16

fn read_le_u16(&self) -> u16

Reads a little-endian u16.

u16s are 2 bytes long.

Method read_le_i64

fn read_le_i64(&self) -> i64

Reads a little-endian i64.

i64s are 8 bytes long.

Method read_le_i32

fn read_le_i32(&self) -> i32

Reads a little-endian i32.

i32s are 4 bytes long.

Method read_le_i16

fn read_le_i16(&self) -> i16

Reads a little-endian i16.

i16s are 2 bytes long.

Method read_le_f64

fn read_le_f64(&self) -> f64

Reads a little-endian f64.

f64s are 8 byte, IEEE754 double-precision floating point numbers.

Method read_le_f32

fn read_le_f32(&self) -> f32

Reads a little-endian f32.

f32s are 4 byte, IEEE754 single-precision floating point numbers.

Method read_u8

fn read_u8(&self) -> u8

Read a u8.

u8s are 1 byte.

Method read_i8

fn read_i8(&self) -> i8

Read an i8.

i8s are 1 byte.

Method write

fn write(&self, v: &[u8])

Write all of the given bytes.

Method seek

fn seek(&self, int, SeekStyle)

Move the current position within the stream. The second parameter determines the position that the first parameter is relative to.

Method tell

fn tell(&self) -> uint

Return the current position within the stream.

Method flush

fn flush(&self) -> int

Flush the output buffer for this stream (if there is one).

Method get_type

fn get_type(&self) -> WriterType

Determine if this Writer is writing to a file or not.

Method write_char

fn write_char(&self, ch: char)

Write a single utf-8 encoded char.

Method write_str

fn write_str(&self, s: &str)

Write every char in the given str, encoded as utf-8.

Method write_line

fn write_line(&self, s: &str)

Write the given str, as utf-8, followed by '\n'.

Method write_int

fn write_int(&self, n: int)

Write the result of passing n through int::to_str_bytes.

Method write_uint

fn write_uint(&self, n: uint)

Write the result of passing n through uint::to_str_bytes.

Method write_le_uint

fn write_le_uint(&self, n: uint)

Write a little-endian uint (number of bytes depends on system).

Method write_le_int

fn write_le_int(&self, n: int)

Write a little-endian int (number of bytes depends on system).

Method write_be_uint

fn write_be_uint(&self, n: uint)

Write a big-endian uint (number of bytes depends on system).

Method write_be_int

fn write_be_int(&self, n: int)

Write a big-endian int (number of bytes depends on system).

Method write_be_u64

fn write_be_u64(&self, n: u64)

Write a big-endian u64 (8 bytes).

Method write_be_u32

fn write_be_u32(&self, n: u32)

Write a big-endian u32 (4 bytes).

Method write_be_u16

fn write_be_u16(&self, n: u16)

Write a big-endian u16 (2 bytes).

Method write_be_i64

fn write_be_i64(&self, n: i64)

Write a big-endian i64 (8 bytes).

Method write_be_i32

fn write_be_i32(&self, n: i32)

Write a big-endian i32 (4 bytes).

Method write_be_i16

fn write_be_i16(&self, n: i16)

Write a big-endian i16 (2 bytes).

Method write_be_f64

fn write_be_f64(&self, f: f64)

Write a big-endian IEEE754 double-precision floating-point (8 bytes).

Method write_be_f32

fn write_be_f32(&self, f: f32)

Write a big-endian IEEE754 single-precision floating-point (4 bytes).

Method write_le_u64

fn write_le_u64(&self, n: u64)

Write a little-endian u64 (8 bytes).

Method write_le_u32

fn write_le_u32(&self, n: u32)

Write a little-endian u32 (4 bytes).

Method write_le_u16

fn write_le_u16(&self, n: u16)

Write a little-endian u16 (2 bytes).

Method write_le_i64

fn write_le_i64(&self, n: i64)

Write a little-endian i64 (8 bytes).

Method write_le_i32

fn write_le_i32(&self, n: i32)

Write a little-endian i32 (4 bytes).

Method write_le_i16

fn write_le_i16(&self, n: i16)

Write a little-endian i16 (2 bytes).

Method write_le_f64

fn write_le_f64(&self, f: f64)

Write a little-endian IEEE754 double-precision floating-point (8 bytes).

Method write_le_f32

fn write_le_f32(&self, f: f32)

Write a little-endian IEEE754 single-precision floating-point (4 bytes).

Method write_u8

fn write_u8(&self, n: u8)

Write a u8 (1 byte).

Method write_i8

fn write_i8(&self, n: i8)

Write a i8 (1 byte).

Method read

fn read(&self, bytes: &mut [u8], len: uint) -> uint

Method read_byte

fn read_byte(&self) -> int

Method eof

fn eof(&self) -> bool

Method seek

fn seek(&self, position: int, style: SeekStyle)

Method tell

fn tell(&self) -> uint

Method read_bytes

fn read_bytes(&self, len: uint) -> ~[u8]

Method read_until

fn read_until(&self, c: u8, include: bool) -> ~str

Method read_line

fn read_line(&self) -> ~str

Method read_chars

fn read_chars(&self, n: uint) -> ~[char]

Method read_char

fn read_char(&self) -> char

Method read_c_str

fn read_c_str(&self) -> ~str

Method read_whole_stream

fn read_whole_stream(&self) -> ~[u8]

Method each_byte

fn each_byte(&self, it: &fn(int) -> bool) -> bool

Method each_char

fn each_char(&self, it: &fn(char) -> bool) -> bool

Method each_line

fn each_line(&self, it: &fn(s: &str) -> bool) -> bool

Method read_lines

fn read_lines(&self) -> ~[~str]

Method read_le_uint_n

fn read_le_uint_n(&self, nbytes: uint) -> u64

Method read_le_int_n

fn read_le_int_n(&self, nbytes: uint) -> i64

Method read_be_uint_n

fn read_be_uint_n(&self, nbytes: uint) -> u64

Method read_be_int_n

fn read_be_int_n(&self, nbytes: uint) -> i64

Method read_le_uint

fn read_le_uint(&self) -> uint

Method read_le_int

fn read_le_int(&self) -> int

Method read_be_uint

fn read_be_uint(&self) -> uint

Method read_be_int

fn read_be_int(&self) -> int

Method read_be_u64

fn read_be_u64(&self) -> u64

Method read_be_u32

fn read_be_u32(&self) -> u32

Method read_be_u16

fn read_be_u16(&self) -> u16

Method read_be_i64

fn read_be_i64(&self) -> i64

Method read_be_i32

fn read_be_i32(&self) -> i32

Method read_be_i16

fn read_be_i16(&self) -> i16

Method read_be_f64

fn read_be_f64(&self) -> f64

Method read_be_f32

fn read_be_f32(&self) -> f32

Method read_le_u64

fn read_le_u64(&self) -> u64

Method read_le_u32

fn read_le_u32(&self) -> u32

Method read_le_u16

fn read_le_u16(&self) -> u16

Method read_le_i64

fn read_le_i64(&self) -> i64

Method read_le_i32

fn read_le_i32(&self) -> i32

Method read_le_i16

fn read_le_i16(&self) -> i16

Method read_le_f64

fn read_le_f64(&self) -> f64

Method read_le_f32

fn read_le_f32(&self) -> f32

Method read_u8

fn read_u8(&self) -> u8

Method read_i8

fn read_i8(&self) -> i8

Method read

fn read(&self, bytes: &mut [u8], len: uint) -> uint

Method read_byte

fn read_byte(&self) -> int

Method eof

fn eof(&self) -> bool

Method seek

fn seek(&self, offset: int, whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method read

fn read(&self, bytes: &mut [u8], len: uint) -> uint

Method read_byte

fn read_byte(&self) -> int

Method eof

fn eof(&self) -> bool

Method seek

fn seek(&self, off: int, whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method new

fn new(f: *libc::FILE) -> FILERes

Method drop

fn drop(&self)

Method read

fn read(&self, bytes: &mut [u8], len: uint) -> uint

Method read_byte

fn read_byte(&self) -> int

Method eof

fn eof(&self) -> bool

Method seek

fn seek(&self, offset: int, whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method eq

fn eq(&self, __arg_0: &WriterType) -> ::bool

Method ne

fn ne(&self, __arg_0: &WriterType) -> ::bool

Method write

fn write(&self, v: &[u8])

Method seek

fn seek(&self, a: int, b: SeekStyle)

Method tell

fn tell(&self) -> uint

Method flush

fn flush(&self) -> int

Method get_type

fn get_type(&self) -> WriterType

Method write

fn write(&self, bs: &[u8])

Method seek

fn seek(&self, off: int, style: SeekStyle)

Method tell

fn tell(&self) -> uint

Method flush

fn flush(&self) -> int

Method get_type

fn get_type(&self) -> WriterType

Method write

fn write(&self, v: &[u8])

Method seek

fn seek(&self, offset: int, whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method flush

fn flush(&self) -> int

Method get_type

fn get_type(&self) -> WriterType

Method write

fn write(&self, v: &[u8])

Method seek

fn seek(&self, _offset: int, _whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method flush

fn flush(&self) -> int

Method get_type

fn get_type(&self) -> WriterType

Method new

fn new(fd: fd_t) -> FdRes

Method drop

fn drop(&self)

Method write_char

fn write_char(&self, ch: char)

Method write_str

fn write_str(&self, s: &str)

Method write_line

fn write_line(&self, s: &str)

Method write_int

fn write_int(&self, n: int)

Method write_uint

fn write_uint(&self, n: uint)

Method write_le_uint

fn write_le_uint(&self, n: uint)

Method write_le_int

fn write_le_int(&self, n: int)

Method write_be_uint

fn write_be_uint(&self, n: uint)

Method write_be_int

fn write_be_int(&self, n: int)

Method write_be_u64

fn write_be_u64(&self, n: u64)

Method write_be_u32

fn write_be_u32(&self, n: u32)

Method write_be_u16

fn write_be_u16(&self, n: u16)

Method write_be_i64

fn write_be_i64(&self, n: i64)

Method write_be_i32

fn write_be_i32(&self, n: i32)

Method write_be_i16

fn write_be_i16(&self, n: i16)

Method write_be_f64

fn write_be_f64(&self, f: f64)

Method write_be_f32

fn write_be_f32(&self, f: f32)

Method write_le_u64

fn write_le_u64(&self, n: u64)

Method write_le_u32

fn write_le_u32(&self, n: u32)

Method write_le_u16

fn write_le_u16(&self, n: u16)

Method write_le_i64

fn write_le_i64(&self, n: i64)

Method write_le_i32

fn write_le_i32(&self, n: i32)

Method write_le_i16

fn write_le_i16(&self, n: i16)

Method write_le_f64

fn write_le_f64(&self, f: f64)

Method write_le_f32

fn write_le_f32(&self, f: f32)

Method write_u8

fn write_u8(&self, n: u8)

Method write_i8

fn write_i8(&self, n: i8)

Method new

fn new() -> BytesWriter

Method write

fn write(&self, v: &[u8])

Method seek

fn seek(&self, offset: int, whence: SeekStyle)

Method tell

fn tell(&self) -> uint

Method flush

fn flush(&self) -> int

Method get_type

fn get_type(&self) -> WriterType

Example

// print is imported into the prelude, and so is always available.
print("hello");

Example

// println is imported into the prelude, and so is always available.
println("hello");

Example

let stderr = std::io::stderr();
stderr.write_str("hello\\n");

Example

let stdin = std::io::stdin();
let line = stdin.read_line();
std::io::print(line);

Example

let stdout = std::io::stdout();
stdout.write_str("hello\\n");