DataMuseum.dk

top - download

    Length: 3004 (0xbbc)
    Names: »XSaveContext.3X«

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

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 58 53 61 76 65 43 6f 6e 74 65 78 74 28 33 58 29 0a 0a 0a 0a   ┆ions        XSaveContext(3X)    ┆
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 58 53 61 76 65 43 6f 6e 74 65 78 74 2c 20 58 46 69 6e 64 43 6f 6e 74 65 78 74 2c 20 58 44   ┆  XSaveContext, XFindContext, XD┆
0x0a0…0c0 65 6c 65 74 65 43 6f 6e 74 65 78 74 2c 20 58 55 6e 69 71 75 65 43 6f 6e 74 65 78 74 20 2d 0a 20   ┆eleteContext, XUniqueContext -  ┆
0x0c0…0e0 20 20 20 20 61 73 73 6f 63 69 61 74 69 76 65 20 6c 6f 6f 6b 2d 75 70 20 72 6f 75 74 69 6e 65 73   ┆    associative look-up routines┆
0x0e0…100 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08   ┆  S S S SY Y Y YN N N NT T T TA ┆
0x100…120 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 69 6e 74 20 58 53 61 76 65 43 6f 6e 74 65   ┆A A AX X X X      int XSaveConte┆
0x120…140 78 74 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 77 2c 20 5f   ┆xt(_ d_ i_ s_ p_ l_ a_ y, _ w, _┆
0x140…160 08 63 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 2c 20 5f 08 64 5f 08 61 5f 08 74 5f   ┆ c_ o_ n_ t_ e_ x_ t, _ d_ a_ t_┆
0x160…180 08 61 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08   ┆ a)            Display *_ d_ i_ ┆
0x180…1a0 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 57 69 6e 64 6f 77   ┆s_ p_ l_ a_ y;            Window┆
0x1a0…1c0 20 5f 08 77 3b 0a 20 20 20 20 20 20 20 20 20 20 20 58 43 6f 6e 74 65 78 74 20 5f 08 63 5f 08 6f   ┆ _ w;            XContext _ c_ o┆
0x1c0…1e0 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 63 61 64 64   ┆_ n_ t_ e_ x_ t;            cadd┆
0x1e0…200 72 5f 74 20 5f 08 64 5f 08 61 5f 08 74 5f 08 61 3b 0a 0a 20 20 20 20 20 69 6e 74 20 58 46 69 6e   ┆r_t _ d_ a_ t_ a;       int XFin┆
0x200…220 64 43 6f 6e 74 65 78 74 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 2c 20   ┆dContext(_ d_ i_ s_ p_ l_ a_ y, ┆
0x220…240 5f 08 77 2c 20 5f 08 63 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 2c 20 5f 08 64 5f   ┆_ w, _ c_ o_ n_ t_ e_ x_ t, _ d_┆
0x240…260 08 61 5f 08 74 5f 08 61 5f 5f 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08 6e 29 0a 20 20 20   ┆ a_ t_ a__ r_ e_ t_ u_ r_ n)    ┆
0x260…280 20 20 20 20 20 20 20 20 44 69 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c   ┆        Display *_ d_ i_ s_ p_ l┆
0x280…2a0 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 57 69 6e 64 6f 77 20 5f 08 77 3b 0a 20   ┆_ a_ y;            Window _ w;  ┆
0x2a0…2c0 20 20 20 20 20 20 20 20 20 20 58 43 6f 6e 74 65 78 74 20 5f 08 63 5f 08 6f 5f 08 6e 5f 08 74 5f   ┆          XContext _ c_ o_ n_ t_┆
0x2c0…2e0 08 65 5f 08 78 5f 08 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 63 61 64 64 72 5f 74 20 2a 5f 08   ┆ e_ x_ t;            caddr_t *_ ┆
0x2e0…300 64 5f 08 61 5f 08 74 5f 08 61 5f 5f 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08 6e 3b 0a 0a   ┆d_ a_ t_ a__ r_ e_ t_ u_ r_ n;  ┆
0x300…320 20 20 20 20 20 69 6e 74 20 58 44 65 6c 65 74 65 43 6f 6e 74 65 78 74 28 5f 08 64 5f 08 69 5f 08   ┆     int XDeleteContext(_ d_ i_ ┆
0x320…340 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 77 2c 20 5f 08 63 5f 08 6f 5f 08 6e 5f 08 74   ┆s_ p_ l_ a_ y, _ w, _ c_ o_ n_ t┆
0x340…360 5f 08 65 5f 08 78 5f 08 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69 73 70 6c 61 79 20 2a 5f   ┆_ e_ x_ t)            Display *_┆
0x360…380 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20 20 20 20 20   ┆ d_ i_ s_ p_ l_ a_ y;           ┆
0x380…3a0 20 57 69 6e 64 6f 77 20 5f 08 77 3b 0a 20 20 20 20 20 20 20 20 20 20 20 58 43 6f 6e 74 65 78 74   ┆ Window _ w;            XContext┆
0x3a0…3c0 20 5f 08 63 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 3b 0a 0a 20 20 20 20 20 58 43   ┆ _ c_ o_ n_ t_ e_ x_ t;       XC┆
0x3c0…3e0 6f 6e 74 65 78 74 20 58 55 6e 69 71 75 65 43 6f 6e 74 65 78 74 28 29 0a 0a 41 08 41 08 41 08 41   ┆ontext XUniqueContext()  A A A A┆
0x3e0…400 52 08 52 08 52 08 52 47 08 47 08 47 08 47 55 08 55 08 55 08 55 4d 08 4d 08 4d 08 4d 45 08 45 08   ┆R R R RG G G GU U U UM M M ME E ┆
0x400…420 45 08 45 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08   ┆E EN N N NT T T TS S S S      _ ┆
0x420…440 63 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 20 20 53 70 65 63 69 66 69 65 73 20   ┆c_ o_ n_ t_ e_ x_ t   Specifies ┆
0x440…460 74 68 65 20 63 6f 6e 74 65 78 74 20 74 79 70 65 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 64 61   ┆the context type to which the da┆
0x460…480 74 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 65 6c 6f 6e 67 73 2e 0a 0a 20 20 20 20   ┆ta                belongs.      ┆
0x480…4a0 20 5f 08 64 5f 08 61 5f 08 74 5f 08 61 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65   ┆ _ d_ a_ t_ a      Specifies the┆
0x4a0…4c0 20 64 61 74 61 20 74 6f 20 62 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20   ┆ data to be associated with the ┆
0x4c0…4e0 77 69 6e 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 6f 77 20 61 6e 64 20 74 79 70 65   ┆win-                dow and type┆
0x4e0…500 2e 0a 0a 20 20 20 20 20 5f 08 64 5f 08 61 5f 08 74 5f 08 61 5f 5f 08 72 5f 08 65 5f 08 74 5f 08   ┆.       _ d_ a_ t_ a__ r_ e_ t_ ┆
0x500…520 75 5f 08 72 5f 08 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 52 65 74 75 72 6e 73 20 61   ┆u_ r_ n                Returns a┆
0x520…540 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 64 61 74 61 2e 0a 0a 20 20 20 20 20 5f 08 64 5f   ┆ pointer to the data.       _ d_┆
0x540…560 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68   ┆ i_ s_ p_ l_ a_ y   Specifies th┆
0x560…580 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 58 20 73 65 72 76 65 72 2e 0a 0a 20   ┆e connection to the X server.   ┆
0x580…5a0 20 20 20 20 5f 08 77 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 77 69   ┆    _ w         Specifies the wi┆
0x5a0…5c0 6e 64 6f 77 20 77 69 74 68 20 77 68 69 63 68 20 74 68 65 20 64 61 74 61 20 69 73 20 61 73 73 6f   ┆ndow with which the data is asso┆
0x5c0…5e0 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 69 61 74 65 64 2e 0a 0a 44 08 44 08 44 08   ┆-                ciated.  D D D ┆
0x5e0…600 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08 49   ┆DE E E ES S S SC C C CR R R RI I┆
0x600…620 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f   ┆ I IP P P PT T T TI I I IO O O O┆
0x620…640 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 49 66 20 61 6e 20 65 6e 74 72 79 20 77 69 74 68 20 74 68   ┆N N N N      If an entry with th┆
0x640…660 65 20 73 70 65 63 69 66 69 65 64 20 77 69 6e 64 6f 77 20 61 6e 64 20 74 79 70 65 20 61 6c 72 65   ┆e specified window and type alre┆
0x660…680 61 64 79 0a 20 20 20 20 20 65 78 69 73 74 73 2c 20 5f 08 58 5f 08 53 5f 08 61 5f 08 76 5f 08 65   ┆ady      exists, _ X_ S_ a_ v_ e┆
0x680…6a0 5f 08 43 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 6f 76 65 72 72 69 64 65 73 20   ┆_ C_ o_ n_ t_ e_ x_ t overrides ┆
0x6a0…6c0 69 74 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 63 6f 6e 2d 0a 20 20 20 20 20   ┆it with the specified con-      ┆
0x6c0…6e0 74 65 78 74 2e 20 20 54 68 65 20 5f 08 58 5f 08 53 5f 08 61 5f 08 76 5f 08 65 5f 08 43 5f 08 6f   ┆text.  The _ X_ S_ a_ v_ e_ C_ o┆
0x6e0…700 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73   ┆_ n_ t_ e_ x_ t function returns┆
0x700…720 20 61 20 6e 6f 6e 7a 65 72 6f 20 65 72 72 6f 72 0a 20 20 20 20 20 63 6f 64 65 20 69 66 20 61 6e   ┆ a nonzero error      code if an┆
0x720…740 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 72 65 64 20 61 6e 64 20 7a 65 72 6f 20 6f 74 68   ┆ error has occurred and zero oth┆
0x740…760 65 72 77 69 73 65 2e 20 20 50 6f 73 73 69 62 6c 65 0a 20 20 20 20 20 65 72 72 6f 72 73 20 61 72   ┆erwise.  Possible      errors ar┆
0x760…780 65 20 5f 08 58 5f 08 43 5f 08 4e 5f 08 4f 5f 08 4d 5f 08 45 5f 08 4d 20 28 6f 75 74 20 6f 66 20   ┆e _ X_ C_ N_ O_ M_ E_ M (out of ┆
0x780…7a0 6d 65 6d 6f 72 79 29 2e 0a 0a 20 20 20 20 20 42 65 63 61 75 73 65 20 69 74 20 69 73 20 61 20 72   ┆memory).       Because it is a r┆
0x7a0…7c0 65 74 75 72 6e 20 76 61 6c 75 65 2c 20 74 68 65 20 64 61 74 61 20 69 73 20 61 20 70 6f 69 6e 74   ┆eturn value, the data is a point┆
0x7c0…7e0 65 72 2e 20 20 54 68 65 0a 20 20 20 20 20 5f 08 58 5f 08 46 5f 08 69 5f 08 6e 5f 08 64 5f 08 43   ┆er.  The      _ X_ F_ i_ n_ d_ C┆
0x7e0…800 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75   ┆_ o_ n_ t_ e_ x_ t function retu┆
0x800…820 72 6e 73 20 61 20 6e 6f 6e 7a 65 72 6f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61 6e 0a 20   ┆rns a nonzero error code if an  ┆
0x820…840 20 20 20 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 72 65 64 20 61 6e 64 20 7a 65 72 6f 20   ┆    error has occurred and zero ┆
0x840…860 6f 74 68 65 72 77 69 73 65 2e 20 20 50 6f 73 73 69 62 6c 65 20 65 72 72 6f 72 73 20 61 72 65 0a   ┆otherwise.  Possible errors are ┆
0x860…880 20 20 20 20 20 5f 08 58 5f 08 43 5f 08 4e 5f 08 4f 5f 08 45 5f 08 4e 5f 08 54 20 28 63 6f 6e 74   ┆     _ X_ C_ N_ O_ E_ N_ T (cont┆
0x880…8a0 65 78 74 2d 6e 6f 74 2d 66 6f 75 6e 64 29 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 44   ┆ext-not-found).       The _ X_ D┆
0x8a0…8c0 5f 08 65 5f 08 6c 5f 08 65 5f 08 74 5f 08 65 5f 08 43 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08   ┆_ e_ l_ e_ t_ e_ C_ o_ n_ t_ e_ ┆
0x8c0…8e0 78 5f 08 74 20 66 75 6e 63 74 69 6f 6e 20 64 65 6c 65 74 65 73 20 74 68 65 20 65 6e 74 72 79 20   ┆x_ t function deletes the entry ┆
0x8e0…900 66 6f 72 20 74 68 65 20 67 69 76 65 6e 0a 20 20 20 20 20 77 69 6e 64 6f 77 20 61 6e 64 20 74 79   ┆for the given      window and ty┆
0x900…920 70 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 69   ┆pe from the data structure.  Thi┆
0x920…940 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 61 6d 65   ┆s function      returns the same┆
0x940…960 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74 68 61 74 20 5f 08 58 5f 08 46 5f 08 69 5f 08 6e 5f 08   ┆ error codes that _ X_ F_ i_ n_ ┆
0x960…980 64 5f 08 43 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 72 65 74 75 72 6e 73 20 69   ┆d_ C_ o_ n_ t_ e_ x_ t returns i┆
0x980…9a0 66 0a 20 20 20 20 20 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 61 72 67 75   ┆f      called with the same argu┆
0x9a0…9c0 6d 65 6e 74 73 2e 20 20 5f 08 58 5f 08 44 5f 08 65 5f 08 6c 5f 08 65 5f 08 74 5f 08 65 5f 08 43   ┆ments.  _ X_ D_ e_ l_ e_ t_ e_ C┆
0x9c0…9e0 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20   ┆_ o_ n_ t_ e_ x_ t does not     ┆
0x9e0…a00 20 66 72 65 65 20 74 68 65 20 64 61 74 61 20 77 68 6f 73 65 20 61 64 64 72 65 73 73 20 77 61 73   ┆ free the data whose address was┆
0xa00…a20 20 73 61 76 65 64 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 55 5f 08 6e 5f 08 69 5f 08   ┆ saved.       The _ X_ U_ n_ i_ ┆
0xa20…a40 71 5f 08 75 5f 08 65 5f 08 43 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20 66 75 6e   ┆q_ u_ e_ C_ o_ n_ t_ e_ x_ t fun┆
0xa40…a60 63 74 69 6f 6e 20 63 72 65 61 74 65 73 20 61 20 75 6e 69 71 75 65 20 63 6f 6e 74 65 78 74 20 74   ┆ction creates a unique context t┆
0xa60…a80 79 70 65 0a 20 20 20 20 20 74 68 61 74 20 6d 61 79 20 62 65 20 75 73 65 64 20 69 6e 20 73 75 62   ┆ype      that may be used in sub┆
0xa80…aa0 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f 20 5f 08 58 5f 08 53 5f 08 61 5f 08 76 5f 08 65   ┆sequent calls to _ X_ S_ a_ v_ e┆
0xaa0…ac0 5f 08 43 5f 08 6f 5f 08 6e 5f 08 74 5f 08 65 5f 08 78 5f 08 74 2e 0a 0a 0a 0a 0a 0a 0a 53 08 53   ┆_ C_ o_ n_ t_ e_ x_ t.       S S┆
0xac0…ae0 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 4c 08   ┆ S SE E E EE E E E A A A AL L L ┆
0xae0…b00 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 5f 08 58 5f 08 6c 5f 08 69 5f 08   ┆LS S S SO O O O      _ X_ l_ i_ ┆
0xb00…b20 62 20 2d 20 5f 08 43 20 5f 08 4c 5f 08 61 5f 08 6e 5f 08 67 5f 08 75 5f 08 61 5f 08 67 5f 08 65   ┆b - _ C _ L_ a_ n_ g_ u_ a_ g_ e┆
0xb20…b40 20 5f 08 58 20 5f 08 49 5f 08 6e 5f 08 74 5f 08 65 5f 08 72 5f 08 66 5f 08 61 5f 08 63 5f 08 65   ┆ _ X _ I_ n_ t_ e_ r_ f_ a_ c_ e┆
0xb40…b60 0a 0a 41 75 67 75 73 74 20 31 39 39 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆  August 1991                   ┆
0xb60…b80 20 20 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   ┆          TX Programmer's Refere┆
0xb80…ba0 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆nce                             ┆
0xba0…bbc 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a               ┆                            ┆