Formatted Scanning Functions.

Variations of formatted scanning functions.

Variations of formatted scanning functions.

SYNOPSIS

    cc ... -ltrio -lm

    #include <trio.h>

DESCRIPTION

This documentation is incomplete. The documentation of the scanf family in [C99] and [UNIX98] also applies to the trio counterparts.

SCANNING

The scanning is controlled by the format string. The format string can contain normal text and conversion indicators. The normal text can be any character except the nil character (\000) and the percent character (\045 = '\'). Conversion indicators consists of an indication character (%), followed by zero or more conversion modifiers, and exactly one conversion specifier.

Modifiers

Positional ( `9$` ) [UNIX98]

See trio_printf.

Specifiers

Percent ( `%` )

Character ( `c` )

Decimal ( `d` )

Floating-point ( `a`, `A`, `e`, `E`, `f`, `F`, `g`, `G` )

Integer ( `i` )

Count ( `n` )

Octal ( `o` )

Pointer ( `p` )

String ( `s` )

Unsigned ( `u` )

Hex ( `x`, `X` )

Scanlist ( ``[] )

Scanlist Exclusion (`^` )

Scanlist Range ( `-` ) [TRIO]

- Only increasing ranges, i.e. ``[a-b], but not ``[b-a].
- Transitive ranges, ie. ``[a-b-c] equals ``[a-c].
- Trailing minus, ie. ``[a-] is interpreted as an `a` and a `-`.
- Duplicates are ignored.

Scanlist Equivalence Class Expression ( ``[= `=`] ) [TRIO]

Locale dependent (LC_COLLATE). Only one expression can appear inside the delimiters.

- ``[=a=] All letters in the same equivalence class as the letter `a`.

        trio_scanf("%[[=a=]b]\n", buffer);
        trio_scanf("%[[=a=][=b=]]\n", buffer);

Scanlist Character Class Expression ( ``[: ``:]) [TRIO] Locale dependent (LC_CTYPE). Only one expression can appear inside the delimiters.

- ``[:alnum:] Same as ``[:alpha:] and ``[:digit:]
- ``[:alpha:] Same as ``[:lower:] and ``[:upper:]
- ``[:cntrl:] Control characters
- ``[:digit:] Decimal digits
- ``[:graph:] Printable characters except space
- ``[:lower:] Lower case alphabetic letters
- ``[:print:] Printable characters
- ``[:punct:] Punctuation
- ``[:space:] Whitespace characters
- ``[:upper:] Upper case alphabetic letters
- ``[:xdigit:] Hexadecimal digits

        trio_scanf("%[[:alnum:]]\n", buffer);
        trio_scanf("%[[:alpha:][:digit:]]\n", buffer);

RETURN VALUES

SEE ALSO

trio_printf

Copyright (C) 2001 - 2006 Bjørn Reese and Daniel Stenberg.