Struct std::ffi::CString

A wrapper for a null-terminated (C) string.

Allocates memory for the string on the heap, so it must be freed.

Example

use std::ffi::CString;
let s = CString::from_slice("Hello, world!");
defer s.free();

libc::puts(s.ptr);
Run this example

Fields

• ptr: &c_char

Methods

• fn from_slice(s: &[u8]) -> CString

  source

  Create a new CString from a string slice

  Allocates memory.

• fn from_raw(ptr: &c_char) -> CString

  source

  Create a CString from a raw pointer to a null-terminated string.

• fn null() -> CString

  source

  A null C string.

• fn len(self: &CString) -> usize

  source

  Returns the length of the string.

• fn as_slice(self: &CString) -> &[u8]

  source

  Returns the contents of the object as a slice.

  See AsSlice for details.

• fn free(self: &mut CString)

  source

  Frees the memory backing the object.

• fn clone(self: &CString) -> CString

  source

  Returns a copy of the object.

• fn move(self: &mut CString) -> CString

  source

  Creates a copy of the object, leaving an inert object behind.

  See Movable for details.

• fn fmt<F>(self: &CString, f: &mut F) -> Result

  F: Formatter<F>

  source

  Write the object into a given formatter.

  See Formattable for details.