DataMuseum.dk

top - download

    Length: 2480 (0x9b0)
    Names: »gets.3s«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/gets.3s« 

Default Hex Dump

0x000…020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x020…040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 67 65 74 73 28 33 73 29 0a 0a 0a 0a   ┆ions                gets(3s)    ┆
0x060…080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x080…0a0 20 20 67 65 74 73 2c 20 66 67 65 74 73 20 2d 20 67 65 74 20 61 20 73 74 72 69 6e 67 20 66 72 6f   ┆  gets, fgets - get a string fro┆
0x0a0…0c0 6d 20 61 20 73 74 72 65 61 6d 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08   ┆m a stream  S S S SY Y Y YN N N ┆
0x0c0…0e0 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 23 08 23 08   ┆NT T T TA A A AX X X X      # # ┆
0x0e0…100 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 75   ┆# #i i i in n n nc c c cl l l lu┆
0x100…120 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08   ┆ u u ud d d de e e e < < < <s s ┆
0x120…140 73 08 73 74 08 74 08 74 08 74 64 08 64 08 64 08 64 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 2e   ┆s st t t td d d di i i io o o o.┆
0x140…160 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 63 08 63 08 63   ┆ . . .h h h h> > > >       c c c┆
0x160…180 08 63 68 08 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 67   ┆ ch h h ha a a ar r r r * * * *g┆
0x180…1a0 08 67 08 67 08 67 65 08 65 08 65 08 65 74 08 74 08 74 08 74 73 08 73 08 73 08 73 28 08 28 08 28   ┆ g g ge e e et t t ts s s s( ( (┆
0x1a0…1c0 08 28 73 08 73 08 73 08 73 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68   ┆ (s s s s) ) ) )      c c c ch h┆
0x1c0…1e0 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 73 08 73 08 73 08   ┆ h ha a a ar r r r * * * *s s s ┆
0x1e0…200 73 3b 08 3b 08 3b 08 3b 0a 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68 61 08 61   ┆s; ; ; ;       c c c ch h h ha a┆
0x200…220 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 66 08 66 08 66 08 66 67 08 67 08 67 08   ┆ a ar r r r * * * *f f f fg g g ┆
0x220…240 67 65 08 65 08 65 08 65 74 08 74 08 74 08 74 73 08 73 08 73 08 73 28 08 28 08 28 08 28 73 08 73   ┆ge e e et t t ts s s s( ( ( (s s┆
0x240…260 08 73 08 73 2c 08 2c 08 2c 08 2c 20 6e 08 6e 08 6e 08 6e 2c 08 2c 08 2c 08 2c 20 73 08 73 08 73   ┆ s s, , , , n n n n, , , , s s s┆
0x260…280 08 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 65 08 65 08 65 08 65 61 08 61 08 61 08 61 6d 08   ┆ st t t tr r r re e e ea a a am ┆
0x280…2a0 6d 08 6d 08 6d 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68   ┆m m m) ) ) )      c c c ch h h h┆
0x2a0…2c0 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 73 08 73 08 73 08 73 3b 08 3b   ┆a a a ar r r r * * * *s s s s; ;┆
0x2c0…2e0 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20   ┆ ; ;      i i i in n n nt t t t ┆
0x2e0…300 6e 08 6e 08 6e 08 6e 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 46 08 46 08 46 08 46 49 08 49 08 49   ┆n n n n; ; ; ;      F F F FI I I┆
0x300…320 08 49 4c 08 4c 08 4c 08 4c 45 08 45 08 45 08 45 20 2a 08 2a 08 2a 08 2a 73 08 73 08 73 08 73 74   ┆ IL L L LE E E E * * * *s s s st┆
0x320…340 08 74 08 74 08 74 72 08 72 08 72 08 72 65 08 65 08 65 08 65 61 08 61 08 61 08 61 6d 08 6d 08 6d   ┆ t t tr r r re e e ea a a am m m┆
0x340…360 08 6d 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53   ┆ m; ; ; ;  D D D DE E E ES S S S┆
0x360…380 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08   ┆C C C CR R R RI I I IP P P PT T ┆
0x380…3a0 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08   ┆T TI I I IO O O ON N N N      _ ┆
0x3a0…3c0 67 5f 08 65 5f 08 74 5f 08 73 20 72 65 61 64 73 20 63 68 61 72 61 63 74 65 72 73 20 66 72 6f 6d   ┆g_ e_ t_ s reads characters from┆
0x3c0…3e0 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 69 6e 70 75 74 20 73 74 72 65 61 6d 2c 20 5f 08 73 5f   ┆ the standard input stream, _ s_┆
0x3e0…400 08 74 5f 08 64 5f 08 69 5f 08 6e 2c 0a 20 20 20 20 20 69 6e 74 6f 20 74 68 65 20 61 72 72 61 79   ┆ t_ d_ i_ n,      into the array┆
0x400…420 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 5f 08 73 2c 20 75 6e 74 69 6c 20 61 20 6e 65 77 6c   ┆ pointed to by _ s, until a newl┆
0x420…440 69 6e 65 20 63 68 61 72 61 63 74 65 72 20 69 73 0a 20 20 20 20 20 72 65 61 64 20 6f 72 20 61 6e   ┆ine character is      read or an┆
0x440…460 20 65 6e 64 2d 6f 66 2d 66 69 6c 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 65 6e 63 6f 75 6e   ┆ end-of-file condition is encoun┆
0x460…480 74 65 72 65 64 2e 20 20 54 68 65 20 6e 65 77 2d 0a 20 20 20 20 20 6c 69 6e 65 20 63 68 61 72 61   ┆tered.  The new-      line chara┆
0x480…4a0 63 74 65 72 20 69 73 20 64 69 73 63 61 72 64 65 64 20 61 6e 64 20 74 68 65 20 73 74 72 69 6e 67   ┆cter is discarded and the string┆
0x4a0…4c0 20 69 73 20 74 65 72 6d 69 6e 61 74 65 64 0a 20 20 20 20 20 77 69 74 68 20 61 20 6e 75 6c 6c 20   ┆ is terminated      with a null ┆
0x4c0…4e0 63 68 61 72 61 63 74 65 72 2e 0a 0a 20 20 20 20 20 5f 08 66 5f 08 67 5f 08 65 5f 08 74 5f 08 73   ┆character.       _ f_ g_ e_ t_ s┆
0x4e0…500 20 72 65 61 64 73 20 63 68 61 72 61 63 74 65 72 73 20 66 72 6f 6d 20 74 68 65 20 5f 08 73 5f 08   ┆ reads characters from the _ s_ ┆
0x500…520 74 5f 08 72 5f 08 65 5f 08 61 5f 08 6d 20 69 6e 74 6f 20 74 68 65 20 61 72 72 61 79 0a 20 20 20   ┆t_ r_ e_ a_ m into the array    ┆
0x520…540 20 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 5f 08 73 2c 20 75 6e 74 69 6c 20 5f 08 6e 2d 31   ┆  pointed to by _ s, until _ n-1┆
0x540…560 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 72 65 61 64 2c 20 6f 72 20 61 20 6e 65 77 6c 69   ┆ characters are read, or a newli┆
0x560…580 6e 65 0a 20 20 20 20 20 63 68 61 72 61 63 74 65 72 20 69 73 20 72 65 61 64 20 61 6e 64 20 74 72   ┆ne      character is read and tr┆
0x580…5a0 61 6e 73 66 65 72 72 65 64 20 74 6f 20 5f 08 73 2c 20 6f 72 20 61 6e 20 65 6e 64 2d 6f 66 2d 66   ┆ansferred to _ s, or an end-of-f┆
0x5a0…5c0 69 6c 65 0a 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65   ┆ile      condition is encountere┆
0x5c0…5e0 64 2e 20 20 54 68 65 20 73 74 72 69 6e 67 20 69 73 20 74 68 65 6e 20 74 65 72 6d 69 6e 61 74 65   ┆d.  The string is then terminate┆
0x5e0…600 64 0a 20 20 20 20 20 77 69 74 68 20 61 20 6e 75 6c 6c 20 63 68 61 72 61 63 74 65 72 2e 0a 0a 20   ┆d      with a null character.   ┆
0x600…620 20 20 20 20 57 68 65 6e 20 75 73 69 6e 67 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 2c 20 69 66 20   ┆    When using _ g_ e_ t_ s, if ┆
0x620…640 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20 61 6e 20 69 6e 70 75 74 20 6c 69 6e 65 20 65 78 63 65   ┆the length of an input line exce┆
0x640…660 65 64 73 20 74 68 65 0a 20 20 20 20 20 73 69 7a 65 20 6f 66 20 5f 08 73 2c 20 69 6e 64 65 74 65   ┆eds the      size of _ s, indete┆
0x660…680 72 6d 69 6e 61 74 65 20 62 65 68 61 76 69 6f 72 20 6d 61 79 20 72 65 73 75 6c 74 2e 20 20 46 6f   ┆rminate behavior may result.  Fo┆
0x680…6a0 72 20 74 68 69 73 20 72 65 61 2d 0a 20 20 20 20 20 73 6f 6e 2c 20 69 74 20 69 73 20 73 74 72 6f   ┆r this rea-      son, it is stro┆
0x6a0…6c0 6e 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 68 61 74 20 67 65 74 73 20 62 65 20 61 76   ┆ngly recommended that gets be av┆
0x6c0…6e0 6f 69 64 65 64 20 69 6e 0a 20 20 20 20 20 66 61 76 6f 72 20 6f 66 20 66 67 65 74 73 2e 0a 0a 53   ┆oided in      favor of fgets.  S┆
0x6e0…700 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41 08 41 08 41 4c 08 4c 08   ┆ S S SE E E EE E E E A A A AL L ┆
0x700…720 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 4c 69 62 72 61 72 79 20 46   ┆L LS S S SO O O O      Library F┆
0x720…740 75 6e 63 74 69 6f 6e 73 20 28 33 29 3a 20 66 65 72 72 6f 72 0a 0a 52 08 52 08 52 08 52 45 08 45   ┆unctions (3): ferror  R R R RE E┆
0x740…760 08 45 08 45 54 08 54 08 54 08 54 55 08 55 08 55 08 55 52 08 52 08 52 08 52 4e 08 4e 08 4e 08 4e   ┆ E ET T T TU U U UR R R RN N N N┆
0x760…780 20 56 08 56 08 56 08 56 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 55 08 55 08 55 08 55 45 08 45   ┆ V V V VA A A AL L L LU U U UE E┆
0x780…7a0 08 45 08 45 0a 20 20 20 20 20 49 66 20 65 6e 64 2d 6f 66 2d 66 69 6c 65 20 69 73 20 65 6e 63 6f   ┆ E E      If end-of-file is enco┆
0x7a0…7c0 75 6e 74 65 72 65 64 20 61 6e 64 20 6e 6f 20 63 68 61 72 61 63 74 65 72 73 20 68 61 76 65 20 62   ┆untered and no characters have b┆
0x7c0…7e0 65 65 6e 0a 20 20 20 20 20 72 65 61 64 2c 20 6e 6f 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65   ┆een      read, no characters are┆
0x7e0…800 20 74 72 61 6e 73 66 65 72 72 65 64 20 74 6f 20 5f 08 73 20 61 6e 64 20 61 20 6e 75 6c 6c 20 70   ┆ transferred to _ s and a null p┆
0x800…820 6f 69 6e 74 65 72 0a 20 20 20 20 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 49 66 20 61 20 72   ┆ointer      is returned.  If a r┆
0x820…840 65 61 64 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 73 75 63 68 20 61 73 20 74 72 79 69 6e 67   ┆ead error occurs, such as trying┆
0x840…860 20 74 6f 20 75 73 65 0a 20 20 20 20 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 20   ┆ to use      these functions on ┆
0x860…880 61 20 66 69 6c 65 20 74 68 61 74 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 6f 70 65 6e 65 64 20   ┆a file that has not been opened ┆
0x880…8a0 66 6f 72 20 72 65 61 64 2d 0a 20 20 20 20 20 69 6e 67 2c 20 61 20 6e 75 6c 6c 20 70 6f 69 6e 74   ┆for read-      ing, a null point┆
0x8a0…8c0 65 72 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 65 72 72 6f 72 20 69 6e 64   ┆er is returned and the error ind┆
0x8c0…8e0 69 63 61 74 6f 72 20 66 6f 72 0a 20 20 20 20 20 74 68 65 20 73 74 72 65 61 6d 20 69 73 20 73 65   ┆icator for      the stream is se┆
0x8e0…900 74 2e 20 20 49 66 20 65 6e 64 2d 6f 66 2d 66 69 6c 65 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65   ┆t.  If end-of-file is encountere┆
0x900…920 64 2c 20 74 68 65 20 45 08 45 08 45 08 45 4f 08 4f 08 4f 08 4f 46 08 46 08 46 08 46 0a 20 20 20   ┆d, the E E E EO O O OF F F F    ┆
0x920…940 20 20 69 6e 64 69 63 61 74 6f 72 20 66 6f 72 20 74 68 65 20 73 74 72 65 61 6d 20 69 73 20 73 65   ┆  indicator for the stream is se┆
0x940…960 74 2e 20 20 4f 74 68 65 72 77 69 73 65 20 5f 08 73 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 0a   ┆t.  Otherwise _ s is returned.  ┆
0x960…980 4d 61 72 63 68 20 31 39 38 39 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆March 1989                      ┆
0x980…9a0 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63   ┆        TX Programmer's Referenc┆
0x9a0…9b0 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                                   ┆e               ┆