txt: ## print-nl.md
  print-nl
  
  Combined from primary sources listed below.
  
  # [In IO::Handle](#___top "go to top of document")[§](#(IO::Handle)_method_print-nl "direct link")
  
  See primary documentation
  [in context](/type/IO/Handle#method_print-nl)
  for **method print-nl**.
  
  ```raku
  method print-nl(IO::Handle:D: --> True)
  ```
  
  Writes the value of `$.nl-out` attribute into the handle. This attribute, by default, is `␤`, but see the [page on newline](/language/newline) for the rules it follows in different platforms and environments.
  
  Attempting to call this method when the handle is [in binary mode](/type/IO/Handle#method_encoding) will result in [`X::IO::BinaryMode`](/type/X/IO/BinaryMode) exception being thrown.
  
  ```raku
  my $fh = 'path/to/file'.IO.open: :w, :nl-out("\r\n");
  $fh.print: "some text";
  $fh.print-nl; # prints \r\n
  $fh.close;
  
  ```
  