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