GammaRay API Documentation  2.11.2
Public Member Functions | Static Public Member Functions | Friends | List of all members
GammaRay::SourceLocation Class Reference

Specifies a source code location. More...

#include <sourcelocation.h>

Public Member Functions

 SourceLocation ()=default
 The default constructor creates a (invalid) cursor at position (-1, -1) with an invalid url.
 SourceLocation (const QUrl &url)
 This constructor creates a (valid) cursor at position (0, 0) with url.
int column () const
 Returns the zero-based column number.
QString displayString () const
 Returns a human-readable version of this source location. More...
bool isValid () const
int line () const
 Returns the zero-based line number.
bool operator== (const SourceLocation &other) const
void setOneBasedColumn (int column)
void setOneBasedLine (int line)
void setUrl (const QUrl &url)
void setZeroBasedColumn (int column)
void setZeroBasedLine (int line)
QUrl url () const

Static Public Member Functions

static SourceLocation fromOneBased (const QUrl &url, int line, int column=1)
static SourceLocation fromZeroBased (const QUrl &url, int line, int column=0)


QDataStreamoperator<< (QDataStream &out, const SourceLocation &location)
QDataStreamoperator>> (QDataStream &in, SourceLocation &location)

Detailed Description

Specifies a source code location.

A source location consists of a document and cursor position

A Cursor represents a position in a Document through a tuple of two ints, namely the line() and column().

Lines and columns start a 0 (=> zero-based numbering).

Member Function Documentation

QString GammaRay::SourceLocation::displayString ( ) const

Returns a human-readable version of this source location.

SourceLocation loc(QUrl::fromLocalFile("file.cpp", 0, 0);
qDebug() << loc.displayString();
=> Prints: file.cpp:1:1
This will use one-based numbering (file.cpp:1:1 instead of file.cpp:0:0)

Klarälvdalens Datakonsult AB (KDAB)
"The Qt, C++ and OpenGL Experts"
Qt-application inspection and manipulation tool