BloombergLP::bdlde::Utf8Util::getLineAndColumnNumber

Synopsis

Declared in <bdlde_utf8util.h>

static
int
getLineAndColumnNumber(
    Uint64* lineNumber,
    Uint64* utf8Column,
    Uint64* startOfLineByteOffset,
    std::streambuf* input,
    Uint64 byteOffset);

Description

For the specified byteOffset in the specified input, load the offset's line number into the specified lineNumber, the column number into the specified utf8Column, and the byte offset for the start of the line into startOfLineByteOffset. Optionally specify lineDelimeter used to the determine line separator. If lineDelimeter is not supplied, lines are delimited using ` `. Return 0 on success, or a non-zero value if location cannot be found in input or if input contains non-UTF-8 characters. The utf8Column is the number of UTF-8 code points between startOfLineByteOffset and byteOffset.

Return Value

0 on success, and a non-zero value otherwise

Parameters

Name	Description
lineNumber	receives the 1-based line number of `byteOffset`
utf8Column	receives the UTF-8 column within the line
startOfLineByteOffset	receives the byte offset of the line start
input	stream buffer containing UTF-8 text
byteOffset	byte offset whose line and column are requested