Function

Pangofind_paragraph_boundary

Declaration [src]

void
pango_find_paragraph_boundary (
  const gchar* text,
  gint length,
  gint* paragraph_delimiter_index,
  gint* next_paragraph_start
)

Description [src]

Locates a paragraph boundary in text.

A boundary is caused by delimiter characters, such as a newline, carriage return, carriage return-newline pair, or Unicode paragraph separator character.

The index of the run of delimiters is returned in paragraph_delimiter_index. The index of the start of the paragrap (index after all delimiters) is stored in next_paragraph_start.

If no delimiters are found, both paragraph_delimiter_index and next_paragraph_start are filled with the length of text (an index one off the end).

Parameters

text const gchar*
 

UTF-8 text.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
length gint
 

Length of text in bytes, or -1 if nul-terminated.

paragraph_delimiter_index gint*
 

Return location for index of delimiter.

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.
next_paragraph_start gint*
 

Return location for start of next paragraph.

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.