sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (1197B)


      1 GRAPHEME\_NEXT\_LINE\_BREAK(3) - Library Functions Manual
      2 
      3 # NAME
      4 
      5 **grapheme\_next\_line\_break** - determine codepoint-offset to next possible line break
      6 
      7 # SYNOPSIS
      8 
      9 **#include <grapheme.h>**
     10 
     11 *size\_t*  
     12 **grapheme\_next\_line\_break**(*const uint\_least32\_t \*str*, *size\_t len*);
     13 
     14 # DESCRIPTION
     15 
     16 The
     17 **grapheme\_next\_line\_break**()
     18 function computes the offset (in codepoints) to the next possible line
     19 break (see
     20 libgrapheme(7))
     21 in the codepoint array
     22 *str*
     23 of length
     24 *len*.
     25 
     26 If
     27 *len*
     28 is set to
     29 `SIZE_MAX`
     30 (stdint.h is already included by grapheme.h) the string
     31 *str*
     32 is interpreted to be NUL-terminated and processing stops when
     33 a codepoint with the value 0 is encountered.
     34 
     35 For UTF-8-encoded input
     36 data
     37 grapheme\_next\_line\_break\_utf8(3)
     38 can be used instead.
     39 
     40 # RETURN VALUES
     41 
     42 The
     43 **grapheme\_next\_line\_break**()
     44 function returns the offset (in codepoints) to the next possible line
     45 break in
     46 *str*
     47 or 0 if
     48 *str*
     49 is
     50 `NULL`.
     51 
     52 # SEE ALSO
     53 
     54 grapheme\_next\_line\_break\_utf8(3),
     55 libgrapheme(7)
     56 
     57 # STANDARDS
     58 
     59 **grapheme\_next\_line\_break**()
     60 is compliant with the Unicode 15.0.0 specification.
     61 
     62 # AUTHORS
     63 
     64 Laslo Hunhold ([dev@frign.de](mailto:dev@frign.de))
     65 
     66 suckless.org - 2022-10-06