Function

Pango.find_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

 Direction: out
 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

 Direction: out
 The called function takes ownership of the data, and is responsible for freeing it