Annotation of coherent/a/usr/man/ALL/stringfunction, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: string functions             Overview            string functions
                      4: 
                      5: 
                      6: 
                      7: 
                      8: The character  string is a  common formation in  C programs.  The
                      9: runtime representation  of a string is an  array of ASCII charac-
                     10: ters  that is  terminated by a  null character  (`\0').  COHERENT
                     11: uses this  representation when a  program contains a  string con-
                     12: stant; for example:
                     13: 
                     14: 
                     15:         "I am a string constant"
                     16: 
                     17: 
                     18: The address of  the first character in the string  is used as the
                     19: starting point  of the string.  A pointer to  a string holds only
                     20: this address.  Note, too, that an array of 20 characters can hold
                     21: a string  of 19 (_n_o_t 20) non-null  characters; the 20th character
                     22: is the null character that terminates the string.
                     23: 
                     24: The following routines are available to help manipulate strings:
                     25: 
                     26: iinnddeexx()   Search string for a character; use ssttrrcchhrr instead
                     27: mmeemmcchhrr()  Search buffer for a character
                     28: mmeemmccmmpp()  Compare two buffers
                     29: mmeemmccppyy()  Copy one buffer into another
                     30: mmeemmsseett()  Initialize a buffer
                     31: ppnnmmaattcchh() Match a string pattern
                     32: rriinnddeexx()  Search string for a character; use ssttrrrrcchhrr instead
                     33: ssttrrccaatt()  Concatenate two strings
                     34: ssttrrcchhrr()  Find a character in a string
                     35: ssttrrccmmpp()  Compare two string
                     36: ssttrrccppyy()  Copy one string into another
                     37: ssttrrccssppnn() Return length for which strings do not match
                     38: ssttrreerrrroorr()Translate error number into string
                     39: ssttrrlleenn()  Measure a string
                     40: ssttrrnnccaatt() Concatenate two strings
                     41: ssttrrnnccmmpp() Compare two strings
                     42: ssttrrnnccppyy() Copy one string into another
                     43: ssttrrppbbrrkk() Find first occurrence of any character in string
                     44: ssttrrrrcchhrr() Find rightmost occurrence of character
                     45: ssttrrssppnn()  Return length for which strings match
                     46: ssttrrssttrr()  Find one string within another
                     47: ssttrrttookk()  Break a string into tokens
                     48: 
                     49: ***** Example *****
                     50: 
                     51: This example  reads from stdin up to NNAMES  names, each of which
                     52: is no  more than MAXLEN characters long.   It then removes dupli-
                     53: cate names,  sorts the names,  and writes the sorted  list to the
                     54: standard  output.   It   demonstrates  the  functions  shellsort,
                     55: strcat, strcmp, strcpy, and strlen.
                     56: 
                     57: 
                     58: 
                     59: 
                     60: 
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: string functions             Overview            string functions
                     70: 
                     71: 
                     72: 
                     73: #include <stdio.h>
                     74: 
                     75: 
                     76: 
                     77: #define NNAMES 512
                     78: #define MAXLEN 60
                     79: 
                     80: 
                     81: 
                     82: char *array[NNAMES];
                     83: char first[MAXLEN], mid[MAXLEN], last[MAXLEN];
                     84: char *space = " ";
                     85: 
                     86: 
                     87: 
                     88: int compare();
                     89: extern char *strcat();
                     90: 
                     91: 
                     92: 
                     93: main()
                     94: {
                     95:           register int index, count, inflag;
                     96:           register char *name;
                     97: 
                     98: 
                     99: 
                    100:           count = 0;
                    101:           while (scanf("%s %s %s\n", first, mid, last) == 3) {
                    102:           strcat(first, space);
                    103:           strcat(mid, space);
                    104:           name = strcat(first, (strcat(mid, last)));
                    105:           inflag = 0;
                    106: 
                    107: 
                    108: 
                    109:           for (index=0; index < count; index++)
                    110:            if (strcmp(array[index], name) == 0)
                    111:             inflag = 1;
                    112: 
                    113: 
                    114: 
                    115:           if (inflag == 0) {
                    116:            if ((array[count] =
                    117:             malloc(strlen(name) + 1)) == NULL) {
                    118:             fprintf(stderr, "Insufficient memory\n");
                    119:             exit(1);
                    120:            }
                    121:            strcpy(array[count], name);
                    122:            count++;
                    123:           }
                    124:           }
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 
                    133: 
                    134: 
                    135: string functions             Overview            string functions
                    136: 
                    137: 
                    138: 
                    139: 
                    140:           shellsort(array, count, sizeof(char *), compare);
                    141:           for (index=0; index < count; index++)
                    142:           printf("%s\n", array[index]);
                    143:           exit(0);
                    144: }
                    145: 
                    146: 
                    147: 
                    148: compare(s1, s2)
                    149: register char **s1, **s2;
                    150: {
                    151:           extern int strcmp();
                    152:           return(strcmp(*s1, *s2));
                    153: }
                    154: 
                    155: 
                    156: ***** See Also *****
                    157: 
                    158: ASCII, libraries
                    159: 
                    160: ***** Notes *****
                    161: 
                    162: The ANSI standard allows adjacent string literals, e.g.:
                    163: 
                    164: 
                    165:           "hello" "world"
                    166: 
                    167: 
                    168: Adjacent string  literals are automatically  concatenated.  Thus,
                    169: the  compiler will  automatically concatenate  the  above example
                    170: into:
                    171: 
                    172: 
                    173:           "helloworld"
                    174: 
                    175: 
                    176: Because this  departs from the Kernighan  and Ritchie description
                    177: of C,  it will  generate a  warning message if  you use  the com-
                    178: piler's -VVSSBBOOOOKK option.
                    179: 
                    180: 
                    181: 
                    182: 
                    183: 
                    184: 
                    185: 
                    186: 
                    187: 
                    188: 
                    189: 
                    190: 
                    191: 
                    192: 
                    193: 
                    194: 
                    195: 
                    196: COHERENT Lexicon                                           Page 3
                    197: 
                    198: 

unix.superglobalmegacorp.com

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