StringIO.open
open
, go back to StringIO module for more information.
Specs
open(binary(), keyword()) :: {:ok, pid()}
open(binary(), (pid() -> res)) :: {:ok, res} when res: var
Creates an IO device.
string
will be the initial input of the newly created
device.
options_or_function
can be a keyword list of options or
a function.
If options are provided, the result will be {:ok, pid}
, returning the
IO device created. The option :capture_prompt
, when set to true
, causes
prompts (which are specified as arguments to IO.get*
functions) to be
included in the device's output.
If a function is provided, the device will be created and sent to the
function. When the function returns, the device will be closed. The final
result will be a tuple with :ok
and the result of the function.
Examples
iex> {:ok, pid} = StringIO.open("foo")
iex> IO.gets(pid, ">")
"foo"
iex> StringIO.contents(pid)
{"", ""}
iex> {:ok, pid} = StringIO.open("foo", capture_prompt: true)
iex> IO.gets(pid, ">")
"foo"
iex> StringIO.contents(pid)
{"", ">"}
iex> StringIO.open("foo", fn pid ->
...> input = IO.gets(pid, ">")
...> IO.write(pid, "The input was #{input}")
...> StringIO.contents(pid)
...> end)
{:ok, {"", "The input was foo"}}
Specs
Creates an IO device.
string
will be the initial input of the newly created
device.
The device will be created and sent to the function given.
When the function returns, the device will be closed. The final
result will be a tuple with :ok
and the result of the function.
Options
:capture_prompt
- if set totrue
, prompts (specified as arguments toIO.get*
functions) are captured in the output. Defaults tofalse
.:encoding
(since v1.10.0) - encoding of the IO device. Allowed values are:unicode
(default) and:latin1
.
Examples
iex> StringIO.open("foo", [], fn pid ->
...> input = IO.gets(pid, ">")
...> IO.write(pid, "The input was #{input}")
...> StringIO.contents(pid)
...> end)
{:ok, {"", "The input was foo"}}
iex> StringIO.open("foo", [capture_prompt: true], fn pid ->
...> input = IO.gets(pid, ">")
...> IO.write(pid, "The input was #{input}")
...> StringIO.contents(pid)
...> end)
{:ok, {"", ">The input was foo"}}