lstlisting line wrapping

Question

How is it possible to let lstlisting wrap lines?

I've troubles with following block:

\begin{lstlisting}[language=java] 
public class MeasureStationControllerV0Test {   
MeasureStationControllerV0 controller;  
MeasureStation ms = new MeasureStation();   
MeasureStationConfiguration config = new MeasureStationConfiguration();     
DataServer dataserver = new DataServer();

In the PDF output there is an overflow:

Other code-snippets look horrible too.

• So have I to manually wrap them or is listings able to handle that?
• Why isn't syntax highlighting working?

Answer 1

Use the options breaklines=true and postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space} for placing a red arrow at the beginning of the broken line to emphasize the line break.

\documentclass{article}
\usepackage{lmodern}  % for bold teletype font
\usepackage{amsmath}  % for \hookrightarrow
\usepackage{xcolor}   % for \textcolor
\usepackage{listings}
\lstset{
  basicstyle=\ttfamily,
  columns=fullflexible,
  frame=single,
  breaklines=true,
  postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space},
}
\begin{document}
\begin{lstlisting}[language=java]
public class MeasureStationControllerV0Test {   
        MeasureStationControllerV0 controller;  
        MeasureStation ms = new MeasureStation();   
        MeasureStationConfiguration config = new MeasureStationConfiguration();     
        DataServer dataserver = new DataServer();
\end{lstlisting}
\end{document}

---

With the minted package you get nice line breaking and syntax highlighting out-of-the-box. Simply specify the breaklines option on your snippet. The downside is that you have to process the document with the --shell-escape option because the external program pygmentize is used to format the source code.

\documentclass{article}
\usepackage{lmodern} % for bold teletype font
\usepackage{minted}
\begin{document}
\begin{minted}[breaklines,frame=single]{java}
public class MeasureStationControllerV0Test {   
        MeasureStationControllerV0 controller;  
        MeasureStation ms = new MeasureStation();   
        MeasureStationConfiguration config = new MeasureStationConfiguration();     
        DataServer dataserver = new DataServer();
\end{minted}
\end{document}

Answer 2

To complement the answer from @henri-menke, besides the option breaklines=true and a postbreak arrow, I find it useful to make the arrow non-selectable in text (works for pdflatex and most pdf readers). This advice comes from another answer using accsupp package: Is there a way to make a "non-selectable" space in LaTeX?

To summarize the solution:

\usepackage{accsupp}
% ...
\lstset{
  basicstyle=\ttfamily,
  columns=fullflexible,
  postbreak=\raisebox{0ex}[0ex][0ex]{\BeginAccSupp{ActualText={}}\ensuremath{\color{gray}\hookrightarrow\space}\EndAccSupp{}},
  breaklines=true
}

A typical arrow could be \raisebox{0ex}[0ex][0ex]{\ensuremath{\color{gray}\hookrightarrow\space}}, but in this case, we put it between \BeginAccSupp{ActualText={}} and \EndAccSupp{}, so that its symbol becomes non-existent for copy and paste.