Return to getfields.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/getfields.3, revision 1.1.1.1

1.1       root        1: .TH GETFIELDS 3
                      2: .CT 2 data_man
                      3: .SH NAME
                      4: getfields, getmfields, setfields \(mi break a string into fields
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B int getfields(str, ptrs, nptrs)
                      8: .B char *str, **ptrs;
                      9: .PP
                     10: .B int getmfields(str, ptrs, nptrs)
                     11: .B char *str, **ptrs;
                     12: .PP
                     13: .B void setfields(fielddelim)
                     14: .B char *fielddelim;
                     15: .fi
                     16: .SH DESCRIPTION
                     17: .I Getfields
                     18: breaks the null-terminated string
                     19: .I str
                     20: into at most
                     21: .I nptrs
                     22: null-terminated fields and places pointers to the start of these fields in the array
                     23: .IR ptrs .
                     24: It returns the number of fields
                     25: and terminates the list of pointers with a zero pointer.
                     26: It overwrites some of the bytes in
                     27: .IR str .
                     28: If there are
                     29: .I nptr
                     30: or more fields, the list will not end with zero
                     31: and the last `field' will extend to the end of the
                     32: input string and may contain delimiters.
                     33: .PP
                     34: A field is defined as a maximal sequence of characters not in a set
                     35: of field delimiters.
                     36: Adjacent fields are separated by exactly one delimiter.
                     37: No field follows a delimiter at the end of string.
                     38: Thus a string of just two delimiter characters
                     39: contains two empty fields,
                     40: and a nonempty string with no delimiters contains
                     41: one field.
                     42: .PP
                     43: .I Getmfields
                     44: is the same as
                     45: .I getfields
                     46: except that fields are separated by maximal strings of
                     47: field delimiters rather than just one.
                     48: .PP
                     49: .I Setfields
                     50: makes the field delimiters (space and tab by default)
                     51: be the characters of the string
                     52: .I fielddelim.
                     53: .SH EXAMPLES
                     54: Print the words in a string, where words are non-whitespace
                     55: strings.
                     56: There is no bound on the number of words.
                     57: .EX
                     58: printwords(string)
                     59: char *string;
                     60: {
                     61:        char *ptrs[2];
                     62:        int n;
                     63:        setfields(" \et\en");           
                     64:        for(n=2; n>=2; string=ptrs[1]) {
                     65:                n = getmfields(string, ptrs, 2);                
                     66:                if(n == 0)
                     67:                        break;
                     68:                if(ptrs[0][0] != 0)     /* skip initial blanks */
                     69:                        printf("%s\en", ptrs[0]);               
                     70:        }
                     71: }
                     72: .EE
                     73: .SH SEE ALSO
                     74: .IR string (3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.