InputStream Manual

Table of Contents

• About
• Usage
• Further Reading

About

An input stream is used to read data from a resource defined with a maxon::Url. maxon::InputStreamInterface is based on maxon::BaseStreamInterface.

Usage

maxon::InputStreamInterface provides these functions:

• maxon::InputStreamInterface::BytesAvailable(): Returns an estimate of the number of bytes that can be read.
• maxon::InputStreamInterface::Read(): Reads the given number of bytes into the given buffer.
• maxon::InputStreamInterface::ReadEOS(): Reads the given number of bytes into the given buffer or reads until the end of the stream.
• maxon::InputStreamInterface::Skip(): Skips over the given number of bytes.

  // This example reads a text file and loads the data into a maxon::String.
 
  // construct file URL
  const maxon::Url url = (targetFolder + maxon::Url("textfile.txt"_s))iferr_return;
 
  // check if file exists
  if (url.IoDetect() == maxon::IODETECT::FILE)
  {
    // open input stream and get file size
    const maxon::InputStreamRef inputStream = url.OpenInputStream() iferr_return;
    const maxon::Int length = inputStream.GetStreamLength() iferr_return;
 
    maxon::BaseArray<maxon::Char> data;
    data.Resize(length) iferr_return;
    inputStream.Read(data) iferr_return;
 
    // convert to string
    const maxon::String text { data };
    DiagnosticOutput("File Content: @", text);
  }

  // This example loads a file from the web and saves it to the local file system.
 
  // check if the given URL references a file on the web
  const maxon::UrlScheme scheme  = webFile.GetScheme();
  const maxon::Bool      isHTTP  = scheme == maxon::URLSCHEME_HTTP;
  const maxon::Bool      isHTTPS = scheme == maxon::URLSCHEME_HTTPS;
 
  if (isHTTP || isHTTPS)
  {
    // read data
 
    // input stream
    const maxon::InputStreamRef inputStream = webFile.OpenInputStream() iferr_return;
    const maxon::Int64 length = inputStream.GetStreamLength() iferr_return;
 
    maxon::BaseArray<maxon::Char> data;
    data.Resize(length) iferr_return;
 
    inputStream.Read(data) iferr_return;
    inputStream.Close() iferr_return;
 
    // save data to file
 
    // prepare file name
    const maxon::Url localFile = (targetFolder + webFile.GetName())iferr_return;
    // output stream
    const maxon::OutputStreamRef outputStream = localFile.OpenOutputStream() iferr_return;
    // write to file
    outputStream.Write(data) iferr_return;
    outputStream.Close() iferr_return;
  }

The input stream maxon::InputStreamInterface::FromBlock can be used to read data from a memory block.

  // This example shows how to access data from a memory block using an InputStreamRef.
 
  const auto memblock = maxon::CharToBlock("Hello World");
  const maxon::InputStreamRef inputStream = maxon::InputStreamInterface::FromBlock().Create(memblock, false) iferr_return;
 
  // read into a maxon::String
 
  // prepare memory
  const maxon::Int length = inputStream.GetStreamLength() iferr_return;
 
  maxon::BaseArray<maxon::Char> data;
  data.Resize(length) iferr_return;
  inputStream.Read(data) iferr_return;
 
  // convert to string
  const maxon::String text { data };
  DiagnosticOutput("Stream Content: @", text);

Further Reading

• Files & Media
• MAXON API Files & Media
• Url Manual
• OutputStream Manual