NATIONAL INSTRUMENTS 320682 Lab Windows Standard Libraries User Manual

Ang SCXI-1121 kay usa ka versatile data acquisition module nga gidisenyo para gamiton sa lain-laing mga pagsukod ug pagkontrol sa mga aplikasyon. Nagtanyag kini og pagkaangay sa LabVIEW, LabWindows, ug uban pang software environment para sa seamless integration sa imong existing setup.

Mga Instruksyon sa Paggamit sa Produkto

Kapitulo 1: ANSI C Library

Kini nga kapitulo naghatag impormasyon sa fdopen function.

Kapitulo 2: Pag-format ug I/O Library

Ang Formatting ug I/O Library naglakip sa mga function alang sa pag-format ug pagmaniobra sa mga string. Gisakup usab niini ang mga espesyal nga gimbuhaton alang sa pag-scan ug pag-format sa datos.

Mga Kalihokan sa Pag-format-Format String:

Pagkat-on unsaon paggamit ang mga string sa format alang sa tukma nga pag-format sa datos.

Mga Pagbag-o sa Pag-format:

Sabta ang lain-laing formatting modifiers nga magamit alang sa pag-customize sa output.

Kapitulo 3: Librarya sa Pagtuki

Ang Librarya sa Pag-analisar nagtanyag mga gimbuhaton alang sa pagtuki sa datos ug pagreport. Naglakip kini sa mga mekanismo sa pagreport sa sayup alang sa episyente nga pag-troubleshoot.

Mga Sugyot sa Paggamit sa Mga Panel sa Function sa Pagtuki:

Pagkuha og mga tip sa epektibong paggamit sa mga panel sa function sa pagtuki alang sa imong mga kinahanglanon sa pagproseso sa datos.

Mga Kasaypanan sa Pag-analisar sa Pagreport:

Pagkat-on unsaon pagreport ug pagdumala sa mga sayup nga nasugatan sa proseso sa pagtuki.

Mga FAQ

P: Unsaon nako pagkuha ang serbisyo sa warranty para sa SCXI-1121?
- A: Aron makakuha og serbisyo sa warranty, kinahanglan una kang makakuha og Return Material Authorization (RMA) nga numero gikan sa pabrika. Kini nga numero kinahanglan nga tin-aw nga markahan sa pakete sa dili pa ibalik ang kagamitan alang sa pag-ayo o pag-ilis. Ang National Instruments naglangkob sa mga gasto sa pagpadala alang sa mga piyesa ubos sa garantiya.
P: Mahimo ba nako nga kopyahon o ipadala kini nga manwal?
- A: Ubos sa mga balaod sa copyright, kini nga publikasyon dili mahimong kopyahon o ipadala sa bisan unsang porma kung wala ang nakasulat nga pagtugot sa National Instruments Corporation.

“`

View Fullscreen

SCXI-1121

LabWindows®/CVI
Sumbanan nga mga Libraries Reference Manual
Hulyo 1996 nga Edisyon Numero sa Bahin 320682C-01
© Copyright 1994, 1996 National Instruments Corporation. Tanang katungod gigahin.

Suporta sa Internet
GPIB: gpib.support@natinst.com DAQ: daq.support@natinst.com VXI: vxi.support@natinst.com LabVIEW: lv.support@natinst.com LabWindows: lw.support@natinst.com HiQ: hiq.support@natinst.com VISA: visa.support@natinst.com Tan-awa: lookout.support@natinst.com FTP Site: ftp.natinst.com Web adres: www.natinst.com
Suporta sa Bulletin Board
BBS Estados Unidos: 512-794-5422 or 800-327-3077 BBS United Kingdom: 01635 551422 BBS France: 1 48 65 15 59
Suporta sa FaxBack
512-418-1111
Suporta sa Telepono (US)
Tel: 512-795-8248 Fax: 512-794-5678
Mga Opisina sa Internasyonal
Australia 03 9 879 9422, Austria 0662 45 79 90 0, Belgium 02 757 00 20, Canada (Ontario) 519 622 9310, Canada (Québec) 514 694 8521 Denmark 45 76 26 00 90 527, Germany 2321 1 48 14, Hong Kong 24 24, Italy 089 741, Japan 31 30 2645, Korea 3186 02 413091, Mexico 03 5472 2970 02, 596 7456 Singapore 95, Spain 800 010 0793, Sweden 0348 433466 32 84, Switzerland 84 00 2265886 91, Taiwan 640 0085 08, UK 730 49

National Instruments Corporate Headquarters

6504 Bridge Point Parkway

Austin, TX 78730-5039 Tel: 512-794-0100

Garantiya

Ang media diin imong nadawat ang software sa National Instruments gigarantiyahan nga dili mapakyas sa pagpatuman sa mga instruksiyon sa pagprograma, tungod sa mga depekto sa mga materyales ug pagkahimo, sulod sa 90 ka adlaw gikan sa petsa sa pagpadala, ingon nga ebidensya sa mga resibo o uban pang dokumentasyon. Ang National Instruments, sa kapilian niini, mag-ayo o mopuli sa software media nga wala magpatuman sa mga instruksiyon sa programming kung ang National Instruments makadawat og pahibalo sa maong mga depekto sa panahon sa warranty. Ang National Instruments wala maggarantiya nga ang operasyon sa software dili mabalda o walay sayop.
Kinahanglang makuha ang numero sa Return Material Authorization (RMA) gikan sa pabrika ug tin-aw nga markahan sa gawas sa pakete sa dili pa dawaton ang bisan unsang kagamitan para sa warranty nga trabaho. Ang mga Nasyonal nga Instrumento mobayad sa mga gasto sa pagpadala sa pagbalik sa mga tag-iya nga bahin nga nasakup sa garantiya.
Ang National Instruments nagtuo nga ang impormasyon niini nga manwal tukma. Ang dokumento giayo pag-ayoviewed alang sa teknikal nga katukma. Kung adunay mga teknikal o typographical nga mga sayup, ang National Instruments adunay katungod sa paghimo sa mga pagbag-o sa sunod nga mga edisyon niini nga dokumento nga wala’y una nga pahibalo sa mga naghupot niini nga edisyon. Ang magbabasa kinahanglan nga mokonsulta sa National Instruments kung adunay mga sayup nga gidudahang. Sa bisan unsa nga panghitabo nga ang National Instruments mahimong manubag sa bisan unsang mga kadaot nga motumaw gikan o may kalabutan niini nga dokumento o sa impormasyon nga anaa niini.
GAWAS SA GISPISYO DINHI, ANG NATIONAL INSTRUMENTS WALAY WARRANTY, PRESYO O GIPAHIBALO, UG ESPEPISYONG GIPASABOT ANG BISAN UNSANG WARRANTY SA KALIGYA O PAGHIMO PARA SA PARTIKULAR NGA KATUYOAN. ANG KATUNGOD SA KUSTOMER NGA MAKABALIK SA MGA KADALA NGA GITUG-AN SA SAYOP O PAGPASAYA SA BAHIN SA NATIONAL INSTRUMENTS KINAHANGLANG LIMITAHAN SA KANTOS NGA GIBAYAD SA KUSTOMER. ANG MGA NATIONAL INSTRUMENTS DILI MANANAB SA MGA KADOT NGA RESULTA GIKAN SA KAWALAN SA DATA, GANTOS, PAGGAMIT SA MGA PRODUKTO, O INSIDENTAL O KONSEQUENTIAL NGA MGA KADOT, BISAN KON GITAMBYO SA POSIBILIDAD NIINI. Kini nga limitasyon sa tulubagon sa National Instruments magamit bisan unsa pa ang porma sa aksyon, bisan sa kontrata o tort, lakip ang pagpabaya. Ang bisan unsang aksyon batok sa National Instruments kinahanglan nga dad-on sa sulod sa usa ka tuig pagkahuman sa hinungdan sa aksyon nga naipon. Ang National Instruments dili manubag sa bisan unsang pagkalangan sa pasundayag tungod sa mga hinungdan nga dili makontrol niini. Ang garantiya nga gihatag dinhi wala maglakip sa mga kadaot, mga depekto, mga malfunction, o mga kapakyasan sa serbisyo tungod sa kapakyasan sa tag-iya sa pagsunod sa mga panudlo sa pag-instalar, operasyon, o pagmentinar sa National Instruments; pagbag-o sa tag-iya sa produkto; pag-abuso, sayop nga paggamit, o pagpabaya sa tag-iya; ug pagkapakyas sa kuryente o mga pagdagsang, sunog, baha, aksidente, mga aksyon sa mga ikatulo nga partido, o uban pang mga panghitabo sa gawas sa makatarunganon nga kontrol.
Copyright
Ubos sa mga balaod sa copyright, kini nga publikasyon dili mahimong kopyahon o ipadala sa bisan unsang porma, elektroniko o mekanikal, lakip ang pag-photocopy, pagrekord, pagtipig sa usa ka sistema sa pagkuha sa impormasyon, o paghubad, sa kinatibuk-an o bahin, kung wala ang una nga sinulat nga pagtugot sa National Instruments. Korporasyon.
Mga marka sa pamatigayon
Ang NI-DAQ®, NI-488.2TM, ug NI-488.2MTM mga marka sa pamatigayon sa National Instruments Corporation.
Ang mga ngalan sa produkto ug kompanya nga nalista mga marka sa pamatigayon o mga ngalan sa pamatigayon sa ilang mga kompanya.

PASIDAAN BAHIN SA MEDIKAL UG KLINIKAL NGA PAGGAMIT SA NATIONAL INSTRUMENTS PRODUCTS
Ang mga produkto sa National Instruments wala gidisenyo nga adunay mga sangkap ug pagsulay nga gituyo aron masiguro ang lebel sa pagkakasaligan nga angay gamiton sa pagtambal ug pagdayagnos sa mga tawo. Ang mga aplikasyon sa mga produkto sa National Instruments nga naglambigit sa medikal o klinikal nga pagtambal mahimong makamugna ug potensyal sa aksidenteng kadaot nga gipahinabo sa pagkapakyas sa produkto, o sa mga sayup sa bahin sa tiggamit o tigdesinyo sa aplikasyon. Ang bisan unsang paggamit o aplikasyon sa mga produkto sa National Instruments alang o naglambigit sa medikal o klinikal nga pagtambal kinahanglan nga himuon sa husto nga pagkabansay ug kwalipikado nga mga medikal nga kawani, ug ang tanan nga tradisyonal nga medikal nga mga panalipod, kagamitan, ug mga pamaagi nga angay sa partikular nga sitwasyon aron malikayan ang grabe nga kadaot o kamatayon kinahanglan. kanunay nga padayon nga gamiton kung ang mga produkto sa National Instruments gigamit. Ang mga produkto sa National Instruments DILI gituyo nga mahimong kapuli sa bisan unsang porma sa natukod nga proseso, pamaagi, o kagamitan nga gigamit sa pagmonitor o pagpanalipod sa kahimsog ug kaluwasan sa tawo sa medikal o klinikal nga pagtambal.

xvi

Mahitungod Niini nga Manwal

Ang LabWindows/CVI Standard Libraries Reference Manual naglangkob sa impormasyon mahitungod sa LabWindows/CVI standard nga mga librarya–ang Graphics Library, ang Analysis Library, ang Formatting ug I/O Library, ang GPIB Library, ang GPIB-488.2 Library, ang RS-232 Library, ang Utility Library, ug ang mga librarya sa sistema. Ang LabWindows/CVI Standard Libraries Reference Manual gituyo alang sa paggamit sa LabWindows/CVI nga mga tiggamit nga nakakompleto na sa Pagsugod sa LabWindows/CVI nga panudlo ug pamilyar sa LabWindows/CVI User Manual. Aron epektibong magamit kini nga manwal, kinahanglan nga pamilyar ka sa LabWindows/CVI ug DOS nga mga sukaranan.
Organisasyon Niini nga Manwal
Ang LabWindows/CVI Standard Libraries Reference Manual giorganisar ingon sa mosunod.
· Kapitulo 1, ANSI C Library, naghulagway sa ANSI C Standard Library nga gipatuman sa LabWindows/CVI.
· Kapitulo 2, Pag-format ug I/O Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI Formatting ug I/O Library, ug adunay daghang examples kon sa unsang paagi sa paggamit kanila. Ang Formatting ug I/O Library naglangkob sa mga function nga input ug output data sa files ug pagmaniobra sa pormat sa datos sa usa ka programa.
· Kapitulo 3, Analysis Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI Analysis Library. Ang Pag-analisar sa Library Function Overview seksyon naglangkob sa kinatibuk-ang impormasyon mahitungod sa Analysis Library function ug mga panel. Ang Analysis Library Function Reference nga seksyon naglangkob sa alpabetikong listahan sa mga deskripsyon sa function.
· Ang Kapitulo 4, GPIB/GPIB-488.2 Library, naghulagway sa NI-488 ug NI-488.2 nga mga gimbuhaton sa LabWindows/CVI GPIB Library, ingon man ang Device Manager nga naglihok sa LabWindows/CVI. Ang GPIB Library Function Overview Ang seksyon naglangkob sa kinatibuk-ang impormasyon bahin sa mga gimbuhaton sa GPIB Library ug mga panel, ang GPIB DLL, ug mga giya ug mga pagdili nga kinahanglan nimong masayran kung mogamit sa GPIB Library. Ang detalyado nga mga paghubit sa NI-488 ug NI-488.2 nga mga gimbuhaton makita sa imong NI-488.2 function reference manual. Ang GPIB Function Reference nga seksyon naglangkob sa alpabetikong listahan sa mga deskripsyon para sa Device Manager functions, ang callback installation functions, ug ang functions alang sa pagbalik sa thread-specific status variables.

xvii

LabWindows/CVI Standard Libraries

Mahitungod Niini nga Manwal
· Kapitulo 5, RS-232 Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI RS-232 Library. Ang RS-232 Library Function Overview seksyon naglangkob sa kinatibuk-ang impormasyon mahitungod sa RS-232 Library function ug mga panel. Ang RS-232 Library Function Reference nga seksyon naglangkob sa alpabetikong listahan sa mga deskripsyon sa function.
· Kapitulo 6, DDE Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI DDE (Dynamic Data Exchange) Library. Ang DDE Library Function Overview Ang seksyon naglangkob sa kinatibuk-ang kasayuran bahin sa mga gimbuhaton ug mga panel sa DDE Library. Ang seksyon sa DDE Library Function Reference adunay alpabetikong listahan sa mga deskripsyon sa function. Kini nga librarya anaa alang sa LabWindows/CVI para sa Microsoft Windows lamang.
· Kapitulo 7, TCP Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI TCP (Transmission Control Protocol) Library. Ang TCP Library Function Overview seksyon naglangkob sa kinatibuk-ang impormasyon mahitungod sa TCP Library function ug mga panel. Ang seksyon sa TCP Library Function Reference adunay alpabetikong listahan sa mga deskripsyon sa function.
· Kapitulo 8, Utility Library, naghulagway sa mga gimbuhaton sa LabWindows/CVI Utility Library. Ang Utility Library adunay mga function nga dili mohaum sa bisan unsang ubang mga librarya sa LabWindows/CVI. Ang seksyon sa Utility Library Function Panels naglangkob sa kinatibuk-ang impormasyon bahin sa mga function ug panel sa Utility Library. Ang seksyon sa Utility Library Function Reference adunay alpabetikong listahan sa mga deskripsyon sa function.
· Kapitulo 9, X Property Library, naghulagway sa mga gimbuhaton sa Lab/Windows CVI X Property Library. Ang X Property Library adunay mga function nga nagbasa ug nagsulat sa mga kabtangan sa ug gikan sa X Windows. Natapos ang X Property Libraryview Ang seksyon naglangkob sa kinatibuk-ang kasayuran bahin sa mga gimbuhaton ug mga panel sa X Property Library. Ang X Property Library Function Reference nga seksyon naglangkob sa alpabetikong listahan sa mga deskripsyon sa function.
· Kapitulo 10, Easy I/O para sa DAQ Library naghulagway sa mga gimbuhaton sa Easy I/O para sa DAQ Library. Ang Sayon nga I/O para sa DAQ Library Function Overview Ang seksyon naglangkob sa kinatibuk-ang kasayuran bahin sa mga gimbuhaton, ug mga panudlo ug mga pagdili nga kinahanglan nimong mahibal-an kung gamiton ang Easy I/O para sa DAQ Library. Ang Easy I/O para sa DAQ Library Function Reference nga seksyon adunay sulod nga alpabetikong listahan sa mga deskripsyon sa function.
· Apendise A, Komunikasyon sa Kustomer, adunay mga porma nga imong magamit sa paghangyo og tabang gikan sa National Instruments o sa pagkomento sa among mga produkto ug mga manwal.
· Ang Glossary adunay usa ka alpabetikong lista ug deskripsyon sa mga termino nga gigamit niini nga manwal, lakip ang mga abbreviation, acronym, metric prefix, mnemonics, ug mga simbolo.
· Ang Index naglangkob sa alpabetikong lista sa mahinungdanong mga termino ug mga hilisgutan niini nga manwal, lakip ang panid diin imong makita ang matag usa.

LabWindows/CVI Standard Libraries

xviii

Mahitungod Niini nga Manwal

Mga Kombensiyon nga Gigamit Niini nga Manwal

Ang mosunod nga mga kombensiyon gigamit niini nga manwal:

maisugon

Ang maisog nga teksto nagpasabut sa usa ka parameter, butang sa menu, kantidad sa pagbalik, function

butang sa panel, o buton sa dialog box o opsyon.

italic

Ang Italic nga teksto nagpasabot ug emphasis, usa ka cross reference, o usa ka pasiuna sa usa ka importanteng konsepto.

maisog nga italic monospace
italic monospace

Bold italic nga teksto nagpasabot sa usa ka nota, pasidaan, o pasidaan.
Ang teksto niini nga font nagpasabut sa teksto o mga karakter nga kinahanglan nimong isulod gikan sa keyboard. Mga seksyon sa code, programming examples, ug syntax exampAng mga les makita usab niini nga font. Kini nga font gigamit usab alang sa tukma nga mga ngalan sa mga disk drive, mga agianan, mga direktoryo, mga programa, mga subprogram, mga subroutine, mga ngalan sa aparato, mga variable, filemga ngalan, ug mga extension, ug alang sa mga pahayag ug komento nga gikuha gikan sa program code.
Ang Italic nga teksto sa kini nga font nagpasabut nga kinahanglan nimo nga ihatag ang angay nga mga pulong o kantidad sa lugar niini nga mga butang.

< >

Ang mga anggulo nga bracket naglakip sa ngalan sa usa ka yawe. Usa ka hyphen tali sa duha

o daghan pang yawe nga mga ngalan nga gilakip sa mga anggulo nga bracket nagpaila nga ikaw

kinahanglan nga dungan nga mopilit sa ginganlan nga mga yawe alang sa example,

Ang simbolo nga » mogiya kanimo pinaagi sa mga nested menu item ug dialog

mga kapilian sa kahon sa usa ka katapusang aksyon. Ang pagkasunodsunod

File » Pag-setup sa Panid » Mga Opsyon » Pagpuli sa mga Font

nagmando kanimo sa pagbitad paubos sa File menu, pilia ang Page Setup

aytem, pilia ang Opsyon, ug sa katapusan pilia ang Substitute Fonts

opsyon gikan sa katapusang dialog box.

mga dalan

Ang mga agianan niini nga manwal gipaila gamit ang mga backslashes () aron mabulag ang mga ngalan sa drive, direktoryo, ug files, sama sa drivenamedir1namedir2namemyfile

Ang IEEE 488, IEEE 488 ug IEEE 488.2 nagtumong sa ANSI/IEEE Standard 488.1-1987, IEEE 488.2 ug sa ANSI/IEEE Standard 488.2-1992, matag usa, nga naghubit sa GPIB.

Ang mga abbreviation, acronym, metric prefix, mnemonics, simbolo, ug termino gilista sa Glossary.

xix

LabWindows/CVI Standard Libraries

Mahitungod Niini nga Manwal
Ang LabWindows/CVI Documentation Set
Para sa detalyadong diskusyon sa pinakamaayong paagi sa paggamit sa LabWindows/CVI documentation set, tan-awa ang seksyon Gamit ang LabWindows/CVI Documentation Set sa Chapter 1, Pasiuna sa LabWindows/CVI sa Pagsugod sa LabWindows/CVI.
May Kalabutan nga Dokumentasyon
Ang mosunod nga mga dokumento naglangkob og impormasyon nga makatabang kanimo samtang imong basahon kini nga manwal:
· ANSI/IEEE Standard 488.1-1987, IEEE Standard Digital Interface para sa Programmable Instrumentation
· ANSI/IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols, ug Common Commands
· Harbison, Samuel P. ug Guy L. Steele, Jr., C: Usa ka Reference Manual, Englewood Cliffs, NJ: Prentice-Hall, Inc., 1995.
· Nyo, Adrian. Xlib Programming Manual. Sebastopol, California: O'Reilly & Associates, 1994. ISBN 0-937175-27-7
· Gettys, James ug Robert W. Scheifler. Xlib–C Language X Interface, MIT X Consortium Standard. Cambridge, Massachussetts: X Consortium, 1994. ISBN (wala)
Komunikasyon sa Kustomer
Gusto sa National Instruments nga makadawat sa imong mga komento sa among mga produkto ug manwal. Interesado kami sa mga aplikasyon nga imong gihimo sa among mga produkto, ug gusto namon nga motabang kung adunay ka mga problema sa kanila. Aron sayon alang kanimo ang pagkontak kanamo, kini nga manwal adunay mga komentaryo ug teknikal nga suporta nga mga porma aron imong kompletohon. Kini nga mga porma anaa sa apendise, Komunikasyon sa Kustomer, sa katapusan niini nga manwal.

LabWindows/CVI Standard Libraries

Kapitulo 1

ANSI C Library

Kini nga kapitulo naghulagway sa ANSI C Standard Library ingon nga gipatuman sa LabWindows/CVI.
Mubo nga sulat: Kung imong i-link ang imong executable o DLL sa usa ka external compiler, imong gigamit ang ANSI C library sa external compiler.
Talaan 1-1. ANSI C Standard nga mga Klase sa Library

Pagdumala sa Kinaiya sa Klase
Pagsulay sa Karakter nga Character Case Mapping Petsa ug Oras Oras sa Operasyon Oras sa Pag-usab sa Oras Pag-format Localization Mathematics Trigonometric Functions Hyperbolic Functions Exp ug Log Functions Power Functions Nonlocal Jumping Signal Handling Input/Output Open/Close Read/Write/Flush Line Input/Output Character Input/Output Formatted Pagkontrol sa Input/Output Buffer File Posisyon File Pagdumala sa Error sa Operasyon sa Sistema

Ulohan File

(nagpadayon)

1-1

LabWindows/CVI Standard Libraries

ANSI C Library

Kapitulo 1

Talaan 1-1. ANSI C Standard Library nga mga Klase (Gipadayon)

Kinatibuk-ang Utility String sa Arithmetic Expression Random Number Generation Memory Management Searching and Sorting Integer Arithmetic Multibyte Character Sets Program Termination Environment
Pagdumala sa String Byte Operations String Operations String Searching Collation Functions Miscellaneous

Ubos nga Level I/O Functions
Ubos sa UNIX mahimo nimong gamiton ang ubos nga lebel nga I/O functions (sama sa open, sopen, read, ug write) gikan sa system library pinaagi sa paglakip sa system header files sa imong programa. Ubos sa Windows mahimo nimong gamiton kini nga mga gimbuhaton pinaagi sa paglakip sa cviincludeansilowlvlio.h sa imong programa. Walay mga panel sa pag-andar ang gihatag alang niini nga mga gimbuhaton.
Sumbanan nga mga Pagdugang sa Pinulongan
Wala gisuportahan sa LabWindows/CVI ang gipalawig nga mga set sa karakter nga nanginahanglan labaw pa sa 8 bits matag karakter. Ingon nga resulta, ang lapad nga tipo sa karakter nga wchar_t parehas sa single-byte nga tipo sa char. Gidawat sa LabWindows/CVI ang halapad nga mga constant sa karakter nga gitakda sa prefix nga L (sama sa L`ab'), apan ang una nga karakter ra ang hinungdanon. Dugang pa, ang mga gimbuhaton sa librarya nga naggamit sa tipo nga wchar_t naglihok lamang sa 8-bit nga mga karakter.
Gisuportahan sa LabWindows/CVI ang mga variable argument function gamit ang ANSI C macros, nga adunay usa ka eksepsiyon: walay bisan usa sa wala matino nga mga argumento nga adunay usa ka tipo sa istruktura. Ingon usa ka sangputanan, ang macro va_arg (ap, tipo) kinahanglan dili gamiton kung ang tipo usa ka istruktura.
Mubo nga sulat: LabWindows/CVI dili mopasidaan kanimo mahitungod niini nga sayop.
Ubos sa UNIX, ang LabWindows/CVI nagpatuman lamang sa C locale nga gipasabot sa ANSI C standard. Ang lumad nga lokal, nga gipiho sa walay sulod nga pisi, "", mao usab ang C lokal. Ang mosunod nga talaan nagpakita sa mga bili sa impormasyon sa lokal para sa lokal nga C.

LabWindows/CVI Standard Libraries

1-2

Kapitulo 1

ANSI C Library

Talaan 1-2. C Lokal nga Impormasyon nga Bili

Ngalan
decimal_point thousands_sep grouping int_curr_symbol
currency_symbol mon_decimal_point mon_thousand_sep mon_grouping positive_sign negative_sign int_frac_digit frac_digit p_cs_precedes p_sep_by_space
n_cs_una sa n_sep_by_space p_sign_posn
n_sign_posn

Type C locale Value Deskripsyon

char *

“.”

Ang karakter sa desimal nga punto alang sa dili kwarta

mga mithi.

char *

Non-monetary digit group separator character

o mga karakter.

char *

Non-monetary digit nga mga grupo.

char *

Ang tulo ka karakter nga internasyonal nga salapi

simbolo, plus ang karakter nga gigamit sa pagbulag sa

internasyonal nga simbolo gikan sa kwarta

gidaghanon.

char *

Ang simbolo sa lokal nga currency alang sa kasamtangan

lokal.

char *

Ang karakter sa desimal nga punto alang sa mga kantidad sa kwarta.

char *

Monetary digit group separator character o

mga karakter.

char *

Monetary digit nga mga grupo.

char *

Pirmahan ang karakter o karakter para sa dili negatibo

kantidad sa kwarta.

char *

Pirmahan ang karakter o karakter para sa negatibo

kantidad sa kwarta.

char

CHAR_MAX Ang mga digit makita sa tuo sa decimal nga punto para sa internasyonal nga mga pormat sa kwarta.

char

CHAR_MAX Ang mga digit makita sa tuo sa desimal nga punto alang sa gawas sa internasyonal nga mga pormat sa kwarta.

char

CHAR_MAX 1 kung ang currency_symbol nag-una sa dili negatibo nga kantidad sa kwarta; 0 kung mosunod.

char

CHAR_MAX

1 kung ang currency_symbol gibulag gikan sa dili negatibo nga kantidad sa kwarta pinaagi sa usa ka wanang; uban 0.

char

CHAR_MAX Sama sa p_cs_precedes, alang sa negatibo nga mga kantidad.

char

CHAR_MAX Sama sa p_sep_by_space, alang sa negatibo nga mga kantidad.

char

CHAR_MAX

Ang pagpahimutang sa positive_sign para sa a
dili negatibo nga kantidad sa kwarta, dayon ang currency_symbol niini.

char

CHAR_MAX

Ang pagpahimutang sa negative_sign para sa a
negatibo nga kantidad sa kwarta, dayon ang currency_symbol niini.

1-3

LabWindows/CVI Standard Libraries

ANSI C Library

Kapitulo 1

Ubos sa Windows, ang LabWindows/CVI nagpatuman sa default locale pinaagi sa paggamit sa angay nga mga butang gikan sa Intl nga seksyon sa WIN.INI file ug angay nga mga gimbuhaton sa Microsoft Windows. Bisan unsa nga wala hisgoti dinhi adunay parehas nga pamatasan ubos sa default nga lokal nga gitakda sa C lokal.
Alang sa LC_NUMERIC lokal:
· decimal_point mapa ngadto sa bili sa sDecimal.
· liboan_sep nga mga mapa sa kantidad nga libo.
Para sa lokal nga LC_MONETARY:
· currency_symbol mapa sa kantidad sa sCurrency.
· mon_decimal_point mapa ngadto sa bili sa sDecimal.
· mon_thousand_sep mga mapa sa kantidad nga sThousand.
· frac_digits mga mapa ngadto sa bili sa iCurrDigits.
· int_frac_digits mapa sa bili sa iCurrDigits.
· Ang p_cs_precedes ug n_cs_precedes gibutang sa 1 kung ang iCurrency katumbas sa 0 o 2, kung dili kini gibutang sa 0.
· Ang p_sep_by_space ug n_sep_by_space gibutang sa 0 kung ang iCurrency katumbas sa 0 o 1, kung dili kini gibutang sa 0.
· Ang p_sign_posn ug n_sign_posn gitino pinaagi sa bili sa iNegCurr sama sa mosunod:

Bili sa iNegCurr 0, 4 1, 5, 8, 9 3, 7, 10 6 2

Bili sa p_sign_posn/n_sign_posn 0 1 2 3 4

Para sa lokal nga LC_CTYPE: · isalnum nga mga mapa sa Windows function isCharAlphaNumeric. · isalpha mapa sa Windows function isCharAlpha.

LabWindows/CVI Standard Libraries

1-4

Kapitulo 1

ANSI C Library

· Ang mas ubos nga mga mapa sa Windows function isCharLower.
· Isupper mapa sa Windows function isCharUpper.
· mas ubos nga mga mapa ngadto sa Windows function AnsiLower.
· Mga mapa sa topper sa Windows function nga AnsiUpper.
Alang sa LC_TIME nga lokal:
· Ang strftime naggamit sa mosunod nga mga butang gikan sa WIN.INI file para sa angay nga format specifiers: sTime, iTime, s1159, s2359, iTLZero, sShortDate, ug sLongDate.
· Ang mga ngalan sa mga adlaw sa semana ug ang mga ngalan sa mga bulan motakdo sa bersyon sa pinulongan sa LabWindows/CVI. Kana mao, ang German nga bersyon sa LabWindows/CVI mogamit sa German nga mga ngalan sa mga bulan ug mga adlaw.
Para sa lokal nga LC_COLLATE:
· strcoll mapa sa Windows function lstrcmp.
Tungod kay ang LabWindows/CVI wala nagsuporta sa gipalawig nga mga set sa karakter nga nanginahanglan labaw pa sa usa ka byte matag karakter, ang usa ka multibyte nga karakter sa LabWindows/CVI sa tinuud usa ka byte nga karakter. Sa samang paagi, ang multibyte sequence usa ka sequence sa single byte nga mga karakter. Tungod kay ang usa ka multibyte nga karakter parehas sa usa ka halapad nga karakter, ang mga gimbuhaton sa pagkakabig nga gihulagway sa kini nga mga seksyon gamay ra ang mahimo kaysa pagbalik sa ilang mga input ingon mga output.

Pagproseso sa Karakter
Gipatuman sa LabWindows/CVI ang tanang pasilidad sa pagproseso sa karakter sa ANSI C isip mga macro ug function. Ang mga macro dili magamit kung ang lebel sa pag-debug sa LabWindows/CVI gibutang sa Standard o Extended, aron ang proteksyon sa tiggamit magamit alang sa mga argumento sa mga gimbuhaton.

Pagproseso sa String
Ubos sa UNIX, ang strcoll function katumbas sa strcmp ug ang kinaiya niini dili apektado sa LC_COLLATE locale. Ubos sa Windows, ang strcoll katumbas sa Windows function lstrcmp. Para sa duha ka plataporma, ang function nga strxfrm naghimo ug string copy gamit ang strncpy ug ibalik ang gitas-on sa ikaduhang argumento niini.

1-5

LabWindows/CVI Standard Libraries

ANSI C Library

Kapitulo 1

Mga Pasilidad sa Input/Output
Ang pag-usab sa function mapakyas kung ang target file anaa na. Ubos sa Microsoft Windows, ang pagbag-o sa ngalan mapakyas kung ang gigikanan ug target files anaa sa lain-laing mga disk drive. Ubos sa UNIX, ang pagbag-o sa ngalan mapakyas kung ang gigikanan ug target files anaa sa lain-laing mga file mga sistema.
Ang mga function fgetpos ug ftell nagtakda sa errno sa EFILPOS sa sayup.

errno Gitakda ni File I/O Function
Ang errno global variable gitakda aron ipakita ang piho nga mga kondisyon sa sayup sa ANSI C file I/O functions ug ang ubos nga level I/O functions. Ang posibleng mga bili sa errno gideklarar sa cviincludeansierrno.h. Adunay usa ka sukaranan nga hugpong sa mga kantidad nga sagad sa tanan nga mga platform. Adunay dugang nga mga kantidad nga espesipiko sa partikular nga mga plataporma.
Ubos sa Windows 3.1, si errno naghatag ug limitado kaayo nga impormasyon. Kung ang operating system nagbalik ug sayup, ang errno gibutang sa EIO.
Ubos sa Windows 95 ug NT, mahimo nimong tawagan ang Windows SDK GetLastError function aron makuha ang piho nga impormasyon sa sistema kung ang errno gibutang sa usa sa mga musunod nga kantidad:
EACCES EBADF EIO ENOENT ENOSPC

Mga Katungdanan sa Matematika
Ang macro HUGE_VAL gihubit sa header math.h ingon man ang mga macro nga FLT_EPSILON, FLT_MAX, FLT_MIN, DBL_EPSILON, DBL_MAX, DBL_MIN, LDBL_EPSILON, LDBL_MAX, ug DBL_MIN nga gipasabot sa header float.h ang tanan nagtumong sa mga variable. Tungod niini, kini nga mga macros dili magamit sa mga lugar diin ang kanunay nga mga ekspresyon gikinahanglan, sama sa global nga pagsugod.

Mga Function sa Oras ug Petsa
Ang oras sa pag-andar nagbalik sa gidaghanon sa mga segundo sukad sa Enero 1, 1990.
Ang mga function mktime ug lokal nga oras nanginahanglan impormasyon sa time zone aron makahimo og husto nga mga resulta. Ang LabWindows/CVI nakakuha og impormasyon sa time zone gikan sa environment variable nga ginganlag TZ, kung kini anaa. Ang bili niini nga variable kinahanglang adunay format nga AAA[S]HH[:MM]BBB, diin ang opsyonal nga mga butang anaa sa square bracket.

LabWindows/CVI Standard Libraries

1-6

Kapitulo 1

ANSI C Library

Ang mga field sa AAA ug BBB nagtino sa mga ngalan sa standard ug daylight savings time zones, matag usa (sama sa EST para sa Eastern Standard Time ug EDT para sa Eastern Daylight Time). Ang opsyonal nga sign field S nagpakita kon ang lokal nga time zone anaa sa kasadpan (+) o sa silangan (-) sa UTC (Greenwich Mean Time). Ang field sa oras (HH) ug ang opsyonal nga field sa minuto (:MM) nagtino sa gidaghanon sa mga oras ug minuto gikan sa UTC. Ingon usa ka example, ang string EST05EDT nagtino sa impormasyon sa time zone para sa silangang bahin sa Estados Unidos.
Ang mga function gmtime, localtime, ug mktime naghimo og mga koreksyon alang sa daylight savings time (DST). Ang LabWindows/CVI naggamit ug set sa mga lagda para sa pagtino kanus-a magsugod ug matapos ang daylight savings time. Usa ka pisi sa mga mensahe file cvimsgs.txt sa LabWindows/CVI bin directory nagtino niini nga mga lagda. Ang mosunod mao ang default value niini nga string.
“:(1986)040102+0:110102-0:(1967)040102-0:110102-0”
Kini nag-ingon nga alang sa mga tuig gikan sa 1986 hangtod karon, ang DST magsugod sa alas 2:00 sa buntag sa unang Domingo sa Abril, ug matapos sa alas 2:00 sa buntag sa kataposang Domingo sa Oktubre. Alang sa mga tuig gikan sa 1967 hangtod 1985, ang DST magsugod sa alas 2:00 sa kaadlawon sa kataposang Domingo sa Marso, ug matapos sa alas 2:00 sa buntag sa kataposang Domingo sa Oktubre. Mahimo nimong usbon ang paagi sa pagtino sa LabWindows/CVI sa DST pinaagi sa pag-ilis niini nga string sa cvimsgs.txt file. Ang countmsg.exe nga programa kinahanglang ipatuman human sa pag-ilis sa teksto file. Kinahanglan nimong ipatuman ang mosunod nga linya.
countmsg cvimsgs.txt

Mga Katungdanan sa Pagkontrol
Ang assert macro nga gihubit sa LabWindows/CVI wala mag-print sa diagnostics sa standard error stream kung ang debugging level kay bisan unsa gawas sa Wala. Hinunoa, kung ang bili sa argumento niini mag-evaluate ngadto sa zero, ang LabWindows/CVI magpakita sa usa ka dialog box nga adunay mensahe nga naglangkob sa file ngalan, numero sa linya, ug ekspresyon nga hinungdan nga napakyas ang pagpahayag.
Ubos sa UNIX, ang sistema nagpasa sa espesipikong sugo ngadto sa Bourne shell (sh) isip input, ingon nga ang kasamtangan nga proseso nagpahigayon sa usa ka paghulat (2V) nga tawag sa sistema ug naghulat hangtud nga ang kabhang natapos. Ang mga callback dili tawgon samtang ang command gipatuman.
Ubos sa Windows, ang executable mahimong usa ka MS DOS o Microsoft Windows executable, lakip ang *.exe, *.com, *.bat, ug *.pif files. Ang function dili mobalik hangtod nga ang command matapos, ug ang user keyboard ug mouse nga mga panghitabo wala panumbalinga hangtod ang command exit. Ang mga callback alang sa asynchronous nga mga panghitabo, sama sa idle nga mga panghitabo, mga mensahe sa Windows, ug VXI interrupts, PostDeferredCall nga mga tawag, ug DAQ nga mga panghitabo gitawag samtang ang command gipatuman. Kung kinahanglan nimo nga ipatuman ang usa ka command nga gitukod sa command.com sama sa kopya, dir, ug uban pa, mahimo nimong tawagan ang system gamit ang command command.com /C DosCommand args, diin ang DosCommand mao ang shell command nga gusto nimo ipatuman. Tan-awa ang imong dokumentasyon sa DOS alang sa dugang nga tabang sa command.com. DOS executables (.exe, .com, ug .bat files) gamita ang mga setting sa _default.pif (sa imong Windows directory) kung kini nagdagan. Mahimo nimong usbon ang ilang prayoridad, mga opsyon sa pagpakita, ug uban pa pinaagi sa pag-edit sa _default.pif

1-7

LabWindows/CVI Standard Libraries

ANSI C Library

Kapitulo 1

o pinaagi sa paghimo og lain nga .pif file. Tan-awa ang imong dokumentasyon sa Microsoft Windows alang sa tabang sa paghimo ug pag-edit sa .pif files.
Kung ang function gipasa sa usa ka null pointer, ang LabWindows/CVI nagbalik sa usa ka dili zero nga kantidad kung adunay usa ka command processor. Ubos sa UNIX, kung ang argumento dili usa ka null pointer, ang programa magbalik ug zero. Ubos sa Microsoft Windows, kung ang argumento dili usa ka null pointer, ang programa mobalik sa zero kung ang programa malampuson nga gisugdan, kung dili kini ibalik ang usa sa mga mosunod nga error code.
-1 Ang sistema wala na sa memorya, ma-executable file korap, o ang mga relokasyon dili balido. -3 File wala makit-an. -4 Ang dalan wala makit-an. -6 Ang pagsulay gihimo sa dinamikong pag-link sa usa ka buluhaton, o adunay usa ka pagpakigbahin o network
sayop sa pagpanalipod. -7 Library nanginahanglan bulag nga mga bahin sa datos alang sa matag buluhaton. -9 Adunay dili igo nga memorya sa pagsugod sa aplikasyon. -11 Ang bersyon sa Windows dili husto. -12 Mapatuman file dili balido. Dili kini usa ka aplikasyon sa Windows o adunay sayup
sa .EXE nga hulagway. -13 Ang aplikasyon gidisenyo alang sa lain nga operating system. -14 Ang aplikasyon gidisenyo alang sa MS-DOS 4.0. -15 Matang sa executable file wala mailhi. -16 Pagsulay nga gihimo aron makarga ang usa ka real-mode nga aplikasyon (gihimo alang sa usa ka naunang bersyon sa Windows.) -17 Ang pagsulay gihimo aron makarga ang ikaduha nga higayon sa usa ka ma-executable file nga adunay daghang datos
mga bahin nga wala gimarkahan nga read-only. -20 Gisulayan ang pagkarga sa usa ka compressed executable file. Ang file kinahanglan nga decompressed
sa dili pa kini makarga. -21 Dynamic-link library (DLL) file dili balido. Usa sa mga DLL nga gikinahanglan sa pagdagan niini
korap ang aplikasyon. -22 Ang aplikasyon nanginahanglan sa Microsoft Windows 32-bit nga mga extension. -23 Dili makit-an ang toolhelp.dll o ang toolhelp.dll nadaot. -24 Dili makagahin ug GetProcUserDefinedHandle.
Ang exit function dili aktuwal nga mag-flush ug mosira sa bukas nga mga sapa. LabWindows/CVI dahon files bukas aron sila magamit gikan sa sulod sa Interactive Window pagkahuman sa pagpatuman sa proyekto matapos. Ang opsyon sa Close Libraries ubos sa Run menu naghimo niini nga paglimpyo sa librarya. Kini nga paglimpyo sa librarya gihimo usab kung imong i-restart ang pagpatuman sa proyekto pinaagi sa pagpili sa Run Project gikan sa Run menu. Ang argumento nga gipasa sa function exit wala gigamit sa LabWindows/CVI environment. Ubos sa UNIX, ang mga standalone executable nga gihimo sa LabWindows/CVI mibalik sa bili sa argumento nga gipasa ngadto sa exit function.

LabWindows/CVI Standard Libraries

1-8

Kapitulo 1

ANSI C Library

Ang UNIX nga bersyon sa LabWindows/CVI naglihok sa tanang signal nga gisuportahan sa UNIX dugang pa sa ANSI C signal.

ANSI C Library Function Reference
Para sa ANSI C function descriptions, konsultaha ang usa ka reference work sama sa C: A Reference Manual nga gilista sa Related Documentation section sa About This Manual. Sa laing bahin, mahimo nimong gamiton ang tabang sa panel sa function sa LabWindows/CVI. Ang mosunod nga paghulagway sa function gihatag tungod kay kini usa ka extension sa ANSI C function set.

fdopen
FILE *fp = fdopen (int filePaggunit, char *mode);

Mubo nga sulat: Kini nga function anaa lamang sa Windows nga bersyon sa LabWindows/CVI.

Katuyoan

Mahimo nimong gamiton kini nga function aron makakuha usa ka pointer sa usa ka buffered I/O stream gikan sa a file gunitanan nga gibalik sa usa sa mosunod nga mga gimbuhaton.

bukas nga sopen

(ubos nga lebel I/O) (ubos nga lebel I/O)

Mahimo nimong gamiton ang kantidad sa pagbalik sama nga nakuha nimo kini gikan sa fopen.

(Bisan tuod kini nga function wala sa ANSI standard, kini gilakip niini nga librarya tungod kay kini nagbalik sa usa ka pointer sa usa ka buffered I/O stream.)

Parameter

Input fileMode sa pagdumala

integer File gunitanan gibalik pinaagi sa bukas o sopen. string Nagtino sa pagbasa/pagsulat, binary/teksto, ug mga paagi sa pagdugang.

Ibalik nga Bili fp

FILE * Pointer sa usa ka buffered I/O file sapa.

Ibalik ang mga Kodigo NULL (0) Kapakyasan. Ang mas espesipikong impormasyon anaa sa errno.

1-9

LabWindows/CVI Standard Libraries

ANSI C Library

Kapitulo 1

Panaghisgot sa Parametro
Ang mode parehas sa parameter sa mode aron ma-fopen.
Kinahanglan nga mogamit ka usa ka kantidad sa mode nga nahiuyon sa mode diin imong giablihan ang orihinal file. Kung mogamit ka sa mga kapabilidad sa pagsulat nga wala magamit kung ang file Ang kuptanan orihinal nga giablihan, ang tawag sa fdopen milampos, apan bisan unsang pagsulay sa pagsulat napakyas. Pananglitan, kung imong giablihan ang file para sa pagbasa lamang, mahimo nimong ipasa ang "rw" sa fdopen, apan ang bisan unsang tawag sa fwrite napakyas.

LabWindows/CVI Standard Libraries

1-10

Kapitulo 2

Pag-format ug I/O Library

Kini nga kapitulo naghulagway sa mga gimbuhaton sa LabWindows/CVI Formatting ug I/O Library, ug adunay daghang examples kon sa unsang paagi sa paggamit kanila. Ang Formatting ug I/O Library naglangkob sa mga function nga input ug output data sa files ug pagmaniobra sa pormat sa datos sa usa ka programa.
Ang Pag-format ug I/O Library Function Overview seksyon naglangkob sa kinatibuk-ang impormasyon mahitungod sa Formatting ug I/O Library function ug mga panel. Tungod kay ang Formatting ug I/O Library managlahi sa daghang bahin gikan sa ubang mga librarya sa LabWindows/CVI, importante kaayo nga basahon sa ibabaw.view sa dili pa basahon ang ubang mga seksyon niini nga kapitulo.
Ang seksyon sa Pag-format ug I/O Library Function Reference adunay alpabetikong listahan sa mga deskripsyon sa function. Kini nga seksyon makatabang sa pagtino sa syntax sa file I/O ug string manipulation functions.
Ang Paggamit sa Formatting ug Scanning Functions nga seksyon naghulagway sa detalye niining espesyal nga klase sa mga gimbuhaton. Bisan kung kini nga mga gimbuhaton gilista sa reference sa function, ang ilang versatility ug komplikado nga kinaiya nagkinahanglan og mas kompleto nga diskusyon.
Ang katapusang seksyon, Pag-format ug I/O Library Programming Examples, adunay daghang examples sa program code nga nagtawag sa Formatting ug I/O Library functions. Kadaghanan sa exampGigamit nila ang mga function sa pag-format ug pag-scan.
Pag-format ug I/O Library Function Overview
Kini nga seksyon naglangkob sa kinatibuk-ang impormasyon nga gikinahanglan para sa pagsabot sa Formatting ug I/O Library function ug panel.
Ang Formatting ug I/O Library Function Panels
Ang Formatting ug I/O Library function panels gi-grupo sa usa ka tree structure sumala sa mga matang sa operasyon nga gihimo. Ang Formatting ug I/O Library function tree gipakita sa Table 2-1.
Ang una ug ikaduha nga lebel nga bold nga mga ulohan sa kahoy mao ang mga ngalan sa mga klase sa function ug mga subclass. Ang mga klase sa function ug mga subclass mga grupo sa mga may kalabutan nga mga panel sa function. Ang ikatulo nga lebel nga mga ulohan sa yano nga teksto mao ang mga ngalan sa indibidwal nga function panel. Ang mga ngalan sa mga function naa sa bold italic sa tuo sa function panels. Tan-awa ang Sample Function Panels para sa Formatting ug Scanning Functions nga seksyon sa ulahi niini nga kapitulo para sa dugang nga impormasyon.

2-1

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Talaan 2-1. Ang Pag-format ug I/O Library Function Tree

Pag-format ug I/O File I/O Open File Duol File Basaha gikan sa File Isulat sa File Array sa File File sa Array Get File Set sa Impormasyon File Manipulasyon sa Pointer String Pagkuhag Gitas-on sa String String ngadto sa Lowercase String ngadto sa Uppercase Fill Bytes Copy Bytes Copy Bytes Kopyahon String Compare Bytes Compare Strings Pangitag Pattern Read Line Write Line Data Formatting Functions Fmt to Memory (Sample Panel) Fmt sa File (Sample Panel) Fmt ngadto sa Stdout (Sample Panel) Mga Function sa Pag-scan Pag-scan gikan sa Mem (Sample Panel) I-scan gikan sa File (Sample Panel) Scan gikan sa Stdin (Sample Panel) Mga Katungdanan sa Status Pagkuha # Na-format nga Bytes Pagkuha sa Format Index Error Pagkuha sa I/O Error Pagkuha sa I/O Error String

BukasFile DuolFile BasahaFile IsulatFile ArrayToFile FilePagkuha sa ToArrayFileSet sa ImpormasyonFileSi Ptr
StringLength StringLowerCase StringUpperCase FillBytes CopyBytes CopyString CompareBytes CompareStrings FindPattern ReadLine WriteLine
Fmt FmtFile FmtOut
I-scan I-scanFile ScanIn
NumFmtdBytes GetFmtErrNdx GetFmtIOError GetFmtIOErrorString

Ang mga klase ug mga subclass sa kahoy gihulagway sa ubos: · Ang File Ang mga panel sa function sa I/O nagbukas, nagsira, nagbasa, nagsulat, ug nakakuha og impormasyon bahin sa files. · Ang String Manipulation function panels nagmaniobra sa mga string ug character buffers.

LabWindows/CVI Standard Libraries

2-2

Kapitulo 2

Pag-format ug I/O Library

· Ang Data Formatting function panels naghimo sa makuti nga formatting operations sa usa ka function call.
Ang Formatting Functions, usa ka subclass sa Data Formatting, adunay mga function panel nga naghiusa ug nag-format sa usa o daghan pa nga tinubdan nga mga butang ngadto sa usa ka target nga butang.
Ang Scanning Functions, usa ka subclass sa Data Formatting, adunay mga function panel nga nagbag-o sa usa ka tinubdan nga butang ngadto sa daghang target nga mga butang.
Ang Status Functions, usa ka subclass sa Data formatting, adunay mga function panel nga nagbalik sa impormasyon mahitungod sa kalampusan o kapakyasan sa usa ka formatting o scanning nga tawag.
Ang online nga tabang sa matag panel adunay piho nga kasayuran bahin sa pag-operate sa matag function panel.

Ang String Manipulation Function
Ang mga gimbuhaton sa String Manipulation nga klase naghimo sa kasagaran nga mga operasyon sama sa pagkopya sa usa ka string ngadto sa lain, pagtandi sa duha ka mga string, o pagpangita sa panghitabo sa usa ka string sa usa ka buffer sa karakter. Kini nga mga gimbuhaton parehas sa katuyoan sa standard nga C string function.

Ang Espesyal nga Kinaiya sa Formatting ug Scanning Functions
Ang mga gimbuhaton sa pag-format ug pag-scan lahi sa kinaiyahan gikan sa ubang mga gimbuhaton sa mga librarya sa LabWindows/CVI. Uban sa pipila ka mga eksepsiyon, ang matag LabWindows/CVI library function adunay usa ka piho nga gidaghanon sa mga parameter, ug ang matag parameter adunay usa ka piho nga tipo sa datos. Ang matag pag-format ug pag-scan nga function, bisan pa, nagkuha usa ka variable nga gidaghanon sa mga parameter, ug ang mga parameter mahimong lainlain nga tipo sa datos. Kini nga kalainan mao ang gikinahanglan aron sa paghatag sa formatting ug scanning function versatility.
Pananglitan, ang usa ka tawag sa function sa Scan naghimo sa lainlaing mga operasyon, sama sa mosunod.
· Pangitaa ang duha ka numeric values sa string:
“ulo: 45, -1.03e-2”
ug ibutang ang unang bili sa integer variable ug ang ikaduha sa tinuod nga variable.
· Kuhaa ang mga elemento gikan sa integer array, ibaylo ang taas ug ubos nga byte sa matag elemento, ug ibutang ang resulta nga mga value sa tinuod nga array.
Aron mahimo kini nga mga operasyon, ang matag pag-format ug pag-scan nga function nagkuha usa ka string sa format ingon usa sa mga parameter niini. Sa epekto, ang usa ka format nga string usa ka mini-programa nga nagtudlo sa pag-format ug pag-scan sa mga gimbuhaton kung giunsa ang pagbag-o sa mga argumento sa input ngadto sa mga argumento sa output. Alang sa pagkamubo, ang mga string sa format gihimo gamit ang mga single-character code. Kini nga mga code mao ang

2-3

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

gihulagway sa detalye sa Paggamit sa Formatting ug Scanning Functions seksyon sa ulahi niini nga kapitulo.
Mahimo nimong makit-an ang pag-format ug pag-scan nga mga gimbuhaton nga labi ka lisud nga mahibal-an kaysa sa ubang mga gimbuhaton sa LabWindows/CVI. Aron matabangan ka niini nga proseso sa pagkat-on, basaha ang mga diskusyon sa Formatting ug I/O Library Programming Examples seksyon sa katapusan niini nga kapitulo.

Pag-format ug I/O Library Function Reference
Kini nga seksyon naghatag ug mubo nga paghulagway sa matag usa sa mga gimbuhaton nga anaa sa LabWindows/CVI Formatting ug I/O Library. Ang LabWindows/CVI Formatting ug I/O Library functions gihan-ay sa alphabetically.

ArrayToFile
int status = ArrayToFile (char *fileNgalan, void *array, int dataType, int numberOfElements, int numberOfGroups, int arrayDataOrder, int fileLayout, int colSepStyle, int fieldWidth, int fileType, int fileAksyon);
Katuyoan
Nagtipig usa ka laray sa a file gamit ang lainlaing mga kapilian sa pag-format. Ang function nagdumala sa paghimo, pag-abli, pagsulat, ug pagsira sa file. Ang file mahimong basahon balik sa ulahi ngadto sa array gamit ang FileToArray function.
Parameter

Input

fileNgalan array dataType numberOfElements numberOfGroups arrayDataOrder fileLayout colSepStyle fieldWidth fileType fileAksyon

string void * integer integer integer integer integer integer integer integer integer

File ngalan sa dalan. Numeric array. Uri sa datos sa elemento sa array. Gidaghanon sa mga elemento sa array. Gidaghanon sa mga grupo sa laray. Giunsa pag-order ang mga grupo file. Direksyon sa pagsulat sa mga grupo sa file. Giunsa pagbulag ang datos sa usa ka linya. Kanunay nga gilapdon tali sa mga kolum. ASCII/binary mode. File lokasyon sa pagbag-o sa pointer.

LabWindows/CVI Standard Libraries

2-4

Kapitulo 2

Pag-format ug I/O Library

Ibalik nga Bili

kahimtang

integer

Nagpakita sa kalampusan / kapakyasan.

Ibalik ang mga Kodigo

Kalampusan.

-1

Sayop sa pagsulay sa pag-abli file.

-2

Sayop sa pagsulay sa pagsira file.

-3

Usa ka I/O error ang nahitabo.

-4

Dili balido nga dataType parameter.

-5

Dili balido nga parameter sa numberOfElements.

-6

Dili balido nga parameter sa numberOfGroups.

-7

Dili balido nga parameter sa arrayDataOrder.

-8

Dili balido fileParameter sa layout.

-9

Dili balido fileType parameter.

-10

Dili balido nga separationStyle parameter.

-11

Dili balido nga fieldWidth parameter.

-12

Dili balido fileParameter sa aksyon.

Panaghisgot sa Parametro
FileAng ngalan mahimong hingpit nga ngalan sa dalan o paryente file ngalan. Kung mogamit ka ug paryente file ngalan, ang file gihimo kalabot sa kasamtangan nga direktoryo sa pagtrabaho.
Ang DataType kinahanglang usa sa mosunod.
VAL_CHAR VAL_SHORT_INTEGER VAL_INTEGER VAL_FLOAT VAL_DOUBLE VAL_UNSIGNED_SHORT_INTEGER VAL_UNSIGNED_INTEGER VAL_UNSIGNED_CHAR
Kung imong i-save ang array data sa ASCII format, mahimo nimong bahinon ang array data ngadto sa mga grupo. Ang mga grupo mahimong isulat ingon nga mga kolum o mga laray. Ang NumberOfGroups nagtino sa gidaghanon sa mga grupo diin bahinon ang datos sa array. Kung dili nimo gusto nga bahinon ang imong datos sa mga grupo, gamita ang 1.
Kung imong bahinon ang imong array data sa mga grupo, ang arrayDataOrder nagtino kung giunsa pag-order ang data sa array. Ang duha ka mga pagpili mao ang mosunod.

2-5

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

· VAL_GROUPS_TOGETHER–tanan nga mga punto sa matag grupo sa datos gituohan nga gitipigan nga sunud-sunod sa han-ay sa datos.
· VAL_DATA_MULTIPLEXED–gituohan nga ang unang punto gikan sa matag grupo sa datos gitipigan nga dungan, gisundan sa ikaduhang punto gikan sa matag grupo ug uban pa.
Kon imong i-save ang array data sa ASCII format, fileLayout nagtino kung giunsa ang data makita sa file. Ang duha ka mga pagpili mao ang mosunod.
· VAL_GROUPS_AS_COLUMNS
· VAL_GROUPS_AS_ROWS
Kung adunay usa ra ka grupo, gamita ang VAL_GROUPS_AS_COLUMNS aron isulat ang matag elemento sa array sa lahi nga linya.
Kung imong gitino nga daghang mga kantidad ang isulat sa matag linya, ang colSepStyle nagtino kung giunsa ang pagbulag sa mga kantidad. Ang mga pagpili mao ang mosunod.
· VAL_CONST_WIDTH–kanunay nga gilapdon sa field para sa matag column
· VAL_SEP_BY_COMMA–mga bili nga gisundan sa mga koma, gawas sa kataposang bili sa linya
· VAL_SEP_BY_TAB–mga bili nga gibulag sa mga tab
Kung nagpiho ka ug colSepStyle sa VAL_CONST_WIDTH, ang fieldWidth nagtino sa gilapdon sa mga column.
FileAng tipo nagtino kung buhaton ba ang file sa ASCII o binary nga pormat.
Ang mga pagpili mao ang mosunod.
· VAL_ASCII
· VAL_BINARY
FileAng aksyon nagtino sa lokasyon sa file sa pagsugod sa pagsulat data kon ang ginganlan file anaa na. Ang mga pagpili mao ang mosunod.
· VAL_TRUNCATE–Ibutang ang file pointer sa sinugdanan sa file ug tangtangon ang naunang mga sulod niini.
· VAL_APPEND–Ang tanan nga mga operasyon sa pagsulat idugang ang datos sa file.
· VAL_OPEN_AS_IS–Mga posisyon sa file pointer sa sinugdanan sa file apan dili makaapekto sa nauna file sulod.

LabWindows/CVI Standard Libraries

2-6

Kapitulo 2

Pag-format ug I/O Library

DuolFile
int nga kahimtang = CloseFile (int filePagdumala); Katuyoan
Nagsira sa file nakig-uban sa filePaggunit. fileAng gunitanan mao ang file gunitanan nga gibalik gikan sa OpenFile function ug nagtino sa file sa pagsira. Parameter

Input

filePaggunit

integer

File gunitanan.

Ibalik nga Bili

kahimtang

integer

Resulta sa pagsira file operasyon.

Ibalik ang mga Kodigo
-1 0

Daotan file gunitanan. Kalampusan.

CompareBytes
int resulta = CompareBytes (char *buffer#1, int buffer#1Index, char *buffer#2, int buffer#2Index, int numberofBytes, int caseSensitive);
Katuyoan
Itandi ang gidaghanon saBytes sugod sa posisyon buffer#1Index sa buffer#1 ngadto sa gidaghanon saBytes sugod sa posisyon buffer#2Index sa buffer#2.
Parameter

Input

buffer#1 buffer#1Index buffer#2 buffer#2Index numberofBytes caseSensitive

string integer string integer integer integer

String 1. Sugod nga posisyon sa buffer#1. String 2. Pagsugod nga posisyon sa buffer#2. Gidaghanon sa mga byte aron itandi. Mode pagkasensitibo sa kaso.

2-7

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Ibalik nga Bili

resulta

integer

Resulta sa operasyon sa pagtandi.

Ibalik ang mga Kodigo
-1 0 1

Mga byte gikan sa buffer#1 mas ubos kay sa bytes gikan sa buffer#2. Mga byte gikan sa buffer#1 parehas sa byte gikan sa buffer#2. Ang mga byte gikan sa buffer#1 mas dako kay sa mga byte gikan sa buffer#2.

Panaghisgot sa Parametro
Parehong buffer#1Index ug buffer#2Index kay zero-based.
Kung ang caseSensitive zero, ang mga alphabetic nga karakter gitandi nga walay pagtagad sa case. Kung dili-zero ang caseSensitive, ang mga karakter sa alpabeto giisip nga managsama lamang kung parehas sila nga kaso.
Ang function nagbalik ug integer value nga nagpakita sa lexicographic nga relasyon tali sa duha ka set sa bytes.

CompareStrings
int resulta = CompareStrings (char *string#1, int string#1Index, char *string#2, int string#2Index, int caseSensitive);
Katuyoan
Itandi ang NUL-terminated string sugod sa position string#1Index of string#1 ngadto sa NUL-terminated string sugod sa position string#2Index of string#2. Parehong string#1Index ug string#2Index kay zero-based.
Parameter

Input

string#1 string#1Index string#2 string#2Index caseSensitive

string integer string integer integer

String 1. Sugod nga posisyon sa string#1. String 2. Pagsugod nga posisyon sa string#2. Mode pagkasensitibo sa kaso.

LabWindows/CVI Standard Libraries

2-8

Kapitulo 2

Pag-format ug I/O Library

Ibalik nga Bili

resulta

integer

Resulta sa operasyon sa pagtandi.

Ibalik ang mga Kodigo
-1 0 1

Mga byte gikan sa string#1 mas ubos kay sa bytes gikan sa string#2. Mga byte gikan sa string#1 parehas sa byte gikan sa string#2. Ang byte gikan sa string#1 mas dako kay sa bytes gikan sa string#2.

Panaghisgot sa Parametro
Kung ang caseSensitive zero, ang mga alphabetic nga karakter gitandi nga walay pagtagad sa case. Kung dili-zero ang caseSensitive, ang mga karakter sa alpabeto managsama lamang kung parehas sila nga kaso.
Ang function nagbalik sa usa ka integer nga kantidad nga nagpakita sa lexicographic nga relasyon tali sa duha ka mga kuwerdas.

CopyBytes
void CopyBytes (char targetBuffer[], int targetIndex, char *sourceBuffer, int sourceIndex, int numberofBytes);
Katuyoan
Gikopya ang gidaghanon saBytes bytes sugod sa position sourceIndex sa sourceBuffer ngadto sa position targetIndex sa targetBuffer.
Parameter

Input nga Paghatag

targetIndex
tinubdanBuffer sourceIndex
numberofBytes targetBuffer

integer
string integer
integer nga string

Pagsugod nga posisyon sa targetBuffer. tinubdan buffer. Pagsugod nga posisyon sa sourceBuffer. Gidaghanon sa mga byte nga kopyahon.
Destinasyon buffer.

Ibalik nga Bili Wala

2-9

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library
Panaghisgot sa Parameter Parehong sourceIndex ug targetIndex kay zero-based. Mahimo nimong gamiton kini nga function bisan kung mag-overlap ang sourceBuffer ug targetBuffer.

Kapitulo 2

CopyString
void CopyString (char targetString[], int targetIndex, char *sourceString, int sourceIndex, int maximum#Bytes);
Katuyoan
Kopyahon ang string sugod sa position sourceIndex of sourceString to position targetIndex of targetString hangtod makopya ang ASCII NUL o maximum#Bytes bytes ang nakopya. Nagdugang ug ASCII NUL kung walay ASCII NUL nga gikopya.
Parameter

Input

targetIndex

integer

tinubdanString

hilo

tinubdanIndex

integer

maximum#Bytes integer

Output targetString

hilo

Pagsugod nga posisyon sa targetString. tinubdan buffer. Pagsugod nga posisyon sa sourceString. Gidaghanon sa mga byte nga kopyahon, walay labot ang ASCII NUL. Destinasyon buffer.

Ibalik nga Bili
Wala
Panaghisgot sa Parametro
Ang sourceIndex ug targetIndex kay zero-based. Kung gusto nimong gamiton ang maximum#Bytes aron mapugngan ang pagsulat lapas sa katapusan sa targetString, siguruha nga hatagan nimo ug lugar ang ASCII NUL. Kay example, kon ang maximum#Bytes kay 40, ang destinasyon buffer kinahanglang adunay labing menos 41 bytes.
Kung dili nimo gusto nga itakda ang usa ka maximum nga gidaghanon sa mga byte nga kopyahon, gamita ang -1 para sa maximum#Bytes.
Mahimo nimong gamiton kini nga function bisan kung mag-overlap ang sourceString ug targetString.
Pahinumdom: Ang bili sa maximum#Bytes kinahanglang dili molapas sa usa ka ubos sa gidaghanon sa mga byte sa target variable.

LabWindows/CVI Standard Libraries

2-10

Kapitulo 2

Pag-format ug I/O Library

FileToArray
int kahimtang = FileToArray (char *fileNgalan, void *array, int dataType, int numberOfElements, int numberOfGroups, int arrayDataOrder, int fileLayout, int fileType);
Katuyoan
Nagbasa sa datos gikan sa a file ngadto sa usa ka array. Mahimong gamiton uban sa files gihimo gamit ang ArrayToFile gimbuhaton. Ang function nagdumala sa paghimo, pag-abli, pagbasa, ug pagsira sa file.
Parameter

Input nga Paghatag

fileNgalan dataType numberOfElements numberOfGroups arrayDataOrder fileLayout fileType array

string integer integer integer integer integer integer void*

File ngalan sa dalan. Uri sa datos sa elemento sa array. Gidaghanon sa mga elemento sa array. Gidaghanon sa mga Grupo sa laray. Giunsa pag-order ang mga grupo file. Direksyon sa pagsulat sa mga grupo sa file. ASCII/binary mode. Numeric array.

Ibalik nga Bili

kahimtang

integer

Nagpakita sa kalampusan o kapakyasan.

Ibalik ang Code
0 -1 -2 -3 -4 -5 -6 -7 -8 -9

Kalampusan. Sayop sa pagsulay sa pag-abli file. Sayop sa pagsulay sa pagsira file. Usa ka I/O error ang nahitabo. Dili balido nga parameter sa arrayDataType. Dili balido nga parameter sa numberOfElements. Dili balido nga parameter sa numberOfGroups. Dili balido nga parameter sa arrayDataOrder. Dili balido fileParameter sa layout. Dili balido fileType parameter.

2-11

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Panaghisgot sa Parametro
FileAng ngalan mahimong hingpit nga ngalan sa dalan o paryente file ngalan. Kung mogamit ka ug paryente file ngalan, ang file nahimutang kalabot sa kasamtangan nga direktoryo sa pagtrabaho.
Ang DataType kinahanglang usa sa mosunod.
· VAL_CHAR · VAL_SHORT_INTEGER · VAL_INTEGER · VAL_FLOAT · VAL_DOUBLE · VAL_UNSIGNED_SHORT_INTEGER · VAL_UNSIGNED_INTEGER · VAL_UNSIGNED_CHAR
Ang NumberOfGroups nagtino sa gidaghanon sa mga grupo diin ang datos sa file gibahin. Ang mga grupo mahimo sa porma sa bisan unsang mga kolum o mga laray. Kung walay mga grupo, gamita ang 1. Kini nga parameter magamit lamang kung ang file Ang tipo kay ASCII.
Kung ang datos gibahin sa mga grupo, ang arrayDataOrder nagtino sa han-ay kung diin ang datos itago sa array. Ang duha ka mga pagpili mao ang mosunod.
· VAL_GROUPS_TOGETHER– tanang punto gikan sa usa ka grupo sa datos gitipigan nga dungan nga gisundan sa tanang punto gikan sa sunod nga grupo sa datos.
· VAL_DATA_MULTIPLEXED–ang unang mga punto gikan sa matag grupo sa datos gitipigan nga sunud-sunod, gisundan sa ikaduhang mga punto gikan sa matag grupo, ug uban pa.
Kung ang file naa sa format nga ASCII, fileLayout nagtino kung giunsa ang data makita sa file. Ang duha ka mga pagpili mao ang mosunod.
· VAL_GROUPS_AS_COLUMNS · VAL_GROUPS_AS_ROWS
Kung adunay usa ra ka grupo, ang VAL_GROUPS_AS_COLUMNS nagtino nga ang matag kantidad sa file naa sa lahi nga linya.
FileAng tipo nagtino kung ang file naa sa ASCII o binary nga pormat. Ang mga pagpili mao ang mosunod.
· VAL_ASCII · VAL_BINARY

LabWindows/CVI Standard Libraries

2-12

Kapitulo 2

Pag-format ug I/O Library

FillBytes
void ang FillBytes (char buffer [], int startingIndex, int numberofBytes, int value); Katuyoan Nagtakda sa gidaghanon saBytes nga mga byte nga nagsugod sa posisyon nga nagsugodIndex sa buffer ngadto sa bili sa ubos nga byte sa bili. Ang startingIndex kay zero-based. Parameter

Input

buffer startingIndex numberofBytes value

string integer integer integer

Destinasyon buffer. Pagsugod nga posisyon sa buffer. Gidaghanon sa mga byte nga pun-on. Bili nga ibutang sa bytes.

Ibalik nga Bili Wala

FindPattern
int ndx = FindPattern (char *buffer, int startingIndex, int numberofBytes, char *pattern, int caseSensitive, int startFromRight);
Katuyoan
Gipangita ang usa ka buffer sa karakter alang sa usa ka sumbanan sa mga byte. Ang sumbanan sa mga byte gipiho sa sumbanan sa string.
Parameter

Input

buffer startingIndex numberofBytes pattern caseSensitive startFromRight

string integer integer string integer integer

Buffer nga pangitaon. Pagsugod nga posisyon sa buffer. Gidaghanon sa mga byte nga pangitaon. Sumbanan nga pangitaon. Case-sensitivity mode. Direksyon sa pagpangita.

2-13

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Ibalik nga Bili

ndx

integer

Index sa buffer diin pattern

nakit-an.

Ibalik ang Code

-1

Wala makit-an ang pattern.

Panaghisgot sa Parametro
Ang buffer nga gipangita mao ang set sa numberofBytes bytes sugod sa posisyon startingIndex sa buffer. Exception: Kung ang numberofBytes kay -1, ang buffer nga gipangita mao ang set sa bytes sugod sa posisyon startingIndex sa buffer hangtod sa unang ASCII NUL. Ang startingIndex kay zero-based.
Kung ang caseSensitive zero, ang mga alphabetic nga karakter gitandi nga walay pagtagad sa case. Kung dili-zero ang caseSensitive, ang mga karakter sa alpabeto giisip nga managsama lamang kung parehas sila nga kaso. Kung ang startFromRight kay zero, ang pinakawala nga panghitabo sa pattern sa buffer makit-an. Kung ang startFromRight dili zero, ang labing tuo nga panghitabo sa pattern sa buffer makit-an.
Kung makit-an ang pattern, ibalik sa pattern ang indeks kalabot sa sinugdanan sa buffer diin nakit-an ang una nga byte sa pattern. Kung ang pattern wala makit-an, ang pattern mobalik -1.
Ang mosunod nga example mobalik 4, nga mao ang index sa ikaduha sa tulo ka mga panghitabo sa ab sa string 1ab2ab3ab4. Ang unang panghitabo gilaktawan tungod kay ang startingIndex kay 3. Sa duha ka nahibiling panghitabo, ang pinakawala makita tungod kay ang startFromRight zero:
ndx = FindPattern (“1ab2ab3ab4”, 3, -1, “AB”, 0, 0);
Sa laing bahin, ang mosunod nga linya mibalik sa 7, nga mao ang indeks sa kataposang panghitabo sa ab, tungod kay ang startFromRight dili zero:
ndx = FindPattern (“1ab2ab3ab4”, 3, -1, “AB”, 0, 1);

Ang Fmt
int n = Fmt (walay *target, char *formatString, source1,…,sourcen);
Katuyoan
Giporma ang source1 ... sourcen nga mga argumento sumala sa mga paghulagway sa formatString argumento.

LabWindows/CVI Standard Libraries

2-14

Kapitulo 2

Pag-format ug I/O Library

Parameter

Input nga Paghatag

formatString

String.

source1,..., sourcen Ang mga tipo kinahanglang motakdo sa formatString sulod.

target

Ang tipo kinahanglang motakdo sa formatString nga mga sulod.

Ibalik nga Bili

integer

Gidaghanon sa source format

natagbaw ang mga specifier.

Balik Code -1

Sayop sa pag-format sa string.

Gamit Kini nga Function
Kini nga function nagbutang sa resulta sa pag-format sa target nga argumento, nga kinahanglan nimong ipasa pinaagi sa reference. Ang bili sa pagbalik nagpakita kung pila ang mga espesipiko sa gigikanan nga format ang natagbaw, o -1 kung ang string sa format nasayop. Ang usa ka kompleto nga paghisgot niini nga function anaa sa Paggamit sa Formatting ug Scanning Functions seksyon sa ulahi niini nga kapitulo.

Ang FmtFile
int n = FmtFile (int fileHandle, char *formatString, source1,...,sourcen);
Katuyoan
Giporma ang source1 ... sourcen nga mga argumento sumala sa mga paghulagway sa formatString argumento. Ang resulta sa pag-format gisulat sa file katumbas sa filePagdumala sa argumento, nga nakuha pinaagi sa usa ka tawag sa LabWindows/CVI function OpenFile.
Parameter

Input

filePagdumala sa formatString tinubdan1,..., tinubdan

Ang mga tipo sa string nga integer kinahanglan nga motakdo sa mga sulod sa formatString

File gunitanan.

2-15

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Ibalik nga Bili

integer

Gidaghanon sa source format

natagbaw ang mga specifier.

Ibalik ang mga Kodigo
-1 -2

Kasaypanan sa I/O sa format sa string.

Gamit Kini nga Function
Ang return value nagpakita kon pila ka source format specifiers ang natagbaw, -1 kon ang format string nasayop, o -2 kon adunay I/O error. Ang usa ka kompleto nga paghisgot niini nga function anaa sa Paggamit sa Formatting ug Scanning Functions seksyon sa ulahi niini nga kapitulo.

FmtOut
int n = FmtOut (char *formatString, source1,…,sourcen); Katuyoan Giporma ang source1 ... sourcen nga mga argumento sumala sa mga paghulagway sa formatString argumento. Ang resulta sa pag-format gisulat sa Standard I/O nga bintana. Parameter

Input

formatString

String.

source1,..., sourcen Ang mga tipo kinahanglang motakdo sa formatString sulod.

Ibalik nga Bili

integer

Gidaghanon sa source format

natagbaw ang mga specifier.

Ibalik ang mga Kodigo
-1 -2

Sayop sa pag-format sa string. I/O sayop.

LabWindows/CVI Standard Libraries

2-16

Kapitulo 2

Pag-format ug I/O Library

PagkuhaFileImpormasyon
int status = PagkuhaFileImpormasyon (char *fileNgalan, taas *fileGidak-on); Katuyoan Pagmatuod kon a file anaa. Ibalik ang integer nga kantidad nga sero kung dili file anaa ug 1 kon file anaa. fileAng gidak-on usa ka taas nga variable nga naglangkob sa file gidak-on sa bytes o zero kung dili file anaa.
Parameter

Input nga Paghatag

fileNgalan fileGidak-on

taas nga pisi

Pathname sa file aron masusi
File gidak-on o zero.

Ibalik nga Bili

kahimtang

integer

Nagpakita kung ang file anaa.

Ibalik ang mga Kodigo
1 0 -1

File anaa. File wala maglungtad. Maximum nga gidaghanon sa files bukas na.

Example
/* Susiha ang presensya sa file A:DATATEST1.DAT. */ /* I-print ang gidak-on niini */ /* kon file anaa o nagpahayag sa mensahe file wala maglungtad. */ int n; taas nga gidak-on; n = PagkuhaFileInfo("a:\data\test1.dat",&gidak-on); kung (n == 0)
FmtOut("File wala.”); lain
FmtOut("File gidak-on = %i[b4]”, gidak-on);

2-17

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

GetFmtErrNdx
int n = GetFmtErrNdx (walay sulod); Katuyoan Ibalik ang zero-based nga index ngadto sa format string diin nahitabo ang sayop sa kataposang pag-format o scanning nga tawag. Parameter
Walay Ibalik nga Bili

integer

Posisyon sa sayop sa format

hilo.

Ibalik ang Code

-1

Walay sayop.

Gamit Kini nga Function
Kung ang format nga string sa nag-una nga tawag adunay usa ka sayup, sama sa usa ka dili balido nga format, o dili angay nga modifier, ang pagbalik nga kantidad nagpakita sa posisyon sulod sa format nga string, sugod sa posisyon nga zero, diin ang sayup nakit-an. Ang function mahimo nga magreport lamang sa usa ka sayup matag tawag, bisan kung daghang mga sayup ang naglungtad sulod sa string.
Example
int i, n; I-scan (“1234”, “%s>%d”, &i); n = GetFmtErrNdx (); Ang /* n adunay bili -1, nga nagpakita nga */ /* walay sayop nga nakit-an sa format nga string. */

GetFmtIOError
int status = GetFmtIOError (walay sulod);
Katuyoan
Kini nga function nagbalik sa piho nga impormasyon sa I/O para sa katapusang tawag sa usa ka Formatting ug I/O function nga nagpahigayon file I/O. Kung malampuson ang katapusan nga function, ang GetLastFmtIOError mobalik nga zero (no

LabWindows/CVI Standard Libraries

2-18

Kapitulo 2

Pag-format ug I/O Library

sayop). Kung ang katapusang function nga nagpahigayon sa I/O nakasugat ug I/O error, ang GetLastFmtIOError nagbalik ug nonzero nga kantidad.
Ibalik nga Bili

kahimtang

integer

Nagpakita sa kalampusan o kapakyasan sa katapusang function nga gihimo file I/O.

Ibalik ang mga Kodigo

FmtIONoErr

FmtIONoFilemangasayup

FmtIOGenErr

FmtIOBadHandleErr 3

FmtIOInsuffMemErr 4

FmtIOFileAdunayErr 5

FmtIOAccessErr

FmtIOInvalArgErr

FmtIOMaxFilesErr

FmtIODiskFullErr

FmtiIONameTooLongErr 10

Walay sayop. File wala makit-an. Kinatibuk-ang I/O nga sayop. Dili balido file gunitanan. Dili igo nga memorya. File anaa na. Gibalibaran ang pagtugot. Dili balido nga argumento. Maximum nga gidaghanon sa files bukas. Puno ang disk. File taas kaayo ang ngalan.

GetFmtIOErrorString
char *message = GetFmtIOErrorString (int errorNum); Katuyoan Gi-convert ang numero sa sayup nga gibalik sa GetLastFmtIOError ngadto sa usa ka makahuluganon nga mensahe sa sayup. Parameter

Input errorNum integer Error Code gibalik sa GetLastFmtIOErr.

Ibalik nga Bili

mensahe

hilo

Pagpasabot sa sayop.

2-19

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

NumFmtdBytes
int n = NumFmtdBytes (walay sulod); Katuyoan Ibalik ang gidaghanon sa mga byte nga gi-format o gi-scan sa miaging pag-format o pag-scan nga tawag. Parameter
Walay Ibalik nga Bili

integer

Gidaghanon sa mga byte nga giporma o

gi-scan.

Gamit Kini nga Function
Kung ang miaging tawag usa ka pag-format nga tawag, ang NumFmtdBytes ibalik ang gidaghanon sa mga byte nga gibutang sa target. Kung ang miaging tawag usa ka tawag sa pag-scan, ibalik sa NumFmtdBytes ang gidaghanon sa mga byte nga gi-scan gikan sa gigikanan. Ang kantidad sa pagbalik dili matino kung wala’y nag-una nga pag-format o pag-scan sa mga tawag.
Pipila ka mga operasyon gamit ang FmtFile ug ScanFile Ang mga rutina mahimong moresulta sa labaw pa sa 64 KB nga gi-format o gi-scan. Tungod kay ang NumFmtdBytes nagbalik sa usa ka integer, ang kantidad niini dili tukma sa kini nga mga kaso. Ang gibalik nga kantidad mobalhin sa dihang mag-format o mag-scan labaw sa 65,535 ka bytes.
Example
doble f; int n; I-scan (“3.1416”, “%s>%f”, &f); n = NumFmtdBytes (); Ang /* n adunay bili nga 6, nga nagpakita nga unom ka byte */ /* ang gi-scan gikan sa source string. */

BukasFile
int kuptanan = BukasFile (char *fileNgalan, int read/writeMode, int action, int fileMatang); Gibuksan ang Katuyoan a file para sa input ug/o output.

LabWindows/CVI Standard Libraries

2-20

Kapitulo 2

Pag-format ug I/O Library

Parameter

Input

fileNgalan read/writeMode nga aksyon fileType

string integer integer integer

Pathname. Mode sa pagbasa/pagsulat. File lokasyon sa pagbag-o sa pointer. ASCII/binary mode.

Ibalik nga Bili

gunitanan

integer

File gunitanan nga gamiton sa sunod nga PagbasaFile/IsulatFile mga tawag.

Ibalik ang Code

-1

Napakyas ang pag-andar, dili maablihan file, o dili maayo nga argumento

aron molihok.

Panaghisgot sa Parametro
fileAng ngalan usa ka ngalan sa agianan nga nagtino sa file nga ablihan. Kung ang argumento sa read/writeMode kay write o read/write, kini nga function nagmugna sa file kung wala pa kini. Kung ang file gilalang, kini gibuhat nga walay panalipod; buot ingnon, ang pagbasa ug pagsulat mahimong himoon niini. Gamita ang function nga GetFileImpormasyon kung gikinahanglan aron matino kung a file anaa na.
read/writeMode nagtino kung giunsa ang file gibuksan:
· VAL_READ_WRITE = abli file alang sa pagbasa ug pagsulat
· VAL_READ_ONLY = bukas file para lang sa pagbasa
· VAL_WRITE_ONLY = bukas file alang sa pagsulat lamang
Ang aksyon nagtino kung papason ang daan nga mga sulud sa file, ug kung pugson ba ang file pointer sa katapusan sa file sa wala pa ang matag operasyon sa pagsulat. Ang aksyon makahuluganon lang kung read/writeMode = write or read/write. Human mabuhat ang mga operasyon sa pagbasa, ang file Ang pointer nagpunting sa byte pagkahuman sa katapusang byte nga gibasa. Ang mga kantidad sa aksyon mao ang mga musunud:
· VAL_TRUNCATE = putlon file (gitangtang ang daan nga mga sulud niini ug gipahimutang ang file pointer sa sinugdanan sa file.
· VAL_APPEND = ayaw putla file (tanan nga mga operasyon sa pagsulat idugang sa katapusan sa file).
· VAL_OPEN_AS_IS = ayaw putla file (mga posisyon sa file pointer sa sinugdanan sa file. )

2-21

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

fileType nagtino kon sa pagtratar sa file ingon ASCII o binary. Sa pagbuhat sa I/O sa a file sa binary mode, walay espesyal nga pagtagad ang gihatag sa carriage returns (CR) ug line feeds (LF). Sa imong pag-abli sa file sa ASCII mode, ang kombinasyon sa CR LF mahubad sa LF kung magbasa, ug ang LF mahubad sa CR LF kung magsulat. fileAng mga bili sa tipo mao ang mosunod:
· VAL_BINARY = binary
· VAL_ASCII = ASCII

BasahaFile
int n = BasahaFile (int filePaggunit, char buffer [], int count);
Katuyoan
Nagbasa hangtod sa pag-ihap sa mga byte sa datos gikan sa a file o STDIN ngadto sa buffer. Ang pagbasa magsugod sa kasamtangan nga posisyon sa file itudlo. Kung makompleto ang function, ang file pointer nagpunting sa sunod nga wala pa mabasa nga karakter sa file.
Parameter

Input nga Paghatag

filePagdumala sa count buffer

integer integer string

File gunitanan. Gidaghanon sa mga byte nga basahon. Input buffer.

Ibalik nga Bili

integer

Gidaghanon sa mga byte nga gibasa.

Ibalik ang mga Kodigo
-1 0

Sayop, lagmit dili maayo nga pagdumala. Misulay sa pagbasa sa miaging katapusan sa-file.

Panaghisgot sa Parametro
fileAng gunitanan mao ang file gunitanan nga gibalik sa OpenFile function. filePagdumala sa mga punto sa file diin gusto nimo basahon. Kung filePagdumala = 0, ang input gibasa gikan sa STDIN, ug walay nauna nga BukasFile gikinahanglan ang tawag. Ang buffer mao ang buffer diin imong gibasa ang datos. Kinahanglang maggahin ka og luna alang niini nga buffer sa dili pa nimo tawgon kini nga function. count nagtino sa gidaghanon sa mga byte nga basahon. ihap kinahanglan dili labaw pa kay sa buffer gidak-on.

LabWindows/CVI Standard Libraries

2-22

Kapitulo 2

Pag-format ug I/O Library

Gamit Kini nga Function
Ang bili sa pagbalik mahimong mas ubos kay sa gidaghanon sa mga byte nga gipangayo kung katapusan sa file naabot sa wala pa matagbaw ang ihap sa byte. Matikdi nga kon imong ablihan ang file sa ASCII mode, ang matag CR LF nga kombinasyon nga gibasa giihap nga 1 ka karakter, tungod kay ang pares gihubad ngadto sa LF kung gitipigan sa buffer.
Mubo nga sulat: Kini nga function wala magtapos sa buffer gamit ang ASCII NUL.

Basaha ang Linya
int n = ReadLine (int filePagdumala, char lineBuffer[], int maximum#Bytes); Katuyoan Pagbasa sa mga byte gikan sa a file hangtod nga adunay masugatan nga linefeed. Parameter

Input

filePaggunit

integer

maximum#Bytes integer

Output

lineBuffer

hilo

File gunitanan.
Pinakataas nga gidaghanon sa mga byte nga basahon ngadto sa linya, walay labot ang ASCII NUL.
Input buffer.

Ibalik nga Bili

integer

Gidaghanon sa mga byte nga gibasa,

walay labot ang linefeed.

Ibalik ang mga Kodigo

-2

Katapusan sa file.

-1

I/O sayop.

Panaghisgot sa Parametro
Kini nga function nagbutang hangtod sa maximum#Bytes bytes, walay labot sa linefeed, ngadto sa lineBuffer. Nagdugang ug ASCII NUL sa lineBuffer. Kung adunay labaw pa sa maximum#Bytes bytes sa wala pa ang linefeed, ang sobra nga byte ilabay.
fileAng gunitanan mao ang file gunitanan nga gibalik gikan sa OpenFile function ug nagtino sa file diin mabasa ang linya. Ang file kinahanglan nga ablihan sa ASCII mode aron ang a

2-23

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

carriage-return/linefeed nga kombinasyon isipon nga linefeed. Kung fileAng pagdumala mao ang zero, ang linya basahon gikan sa standard input.
Ang lineBuffer kay usa ka character buffer. Kinahanglan nga kini igo nga gidak-on nga adunay labing kadaghan nga #Bytes nga mga byte ug usa ka ASCII NUL.
Gibalik sa ReadLine ang gidaghanon sa mga byte nga gibasa gikan sa file, lakip ang gilabay nga mga byte, apan dili apil ang linefeed. Busa, ang pagbalik nga kantidad molapas sa maximum#Bytes kung ug kung ang mga byte ilabay lamang.
Kung walay mga byte nga mabasa tungod kay ang katapusan sa file naabot na, ang ReadLine mibalik -2. Kung mahitabo ang sayup sa I/O, ang ReadLine mobalik -1.

I-scan
int n = I-scan (walay * tinubdan, char *formatString, targetptr1,…,targetptrn); Katuyoan Nag-scan sa usa ka butang nga gigikanan sa memorya ug gibahin kini sa mga bahin nga bahin sumala sa mga espesipiko sa format nga makita sa usa ka formatString. Ang mga sangkap dayon gibutang sa target nga mga parameter. Parameter

Input nga Paghatag

source formatString targetptr1,…,targetptrn

Ang tipo kinahanglang motakdo sa formatString contents string. Ang mga tipo kinahanglang motakdo sa mga sulod sa formatString.

Ibalik nga Bili

integer Gidaghanon sa target nga format

natagbaw ang mga specifier.

Balik Code -1

Sayop sa pag-format sa string.

Gamit Kini nga Function
Ang bili sa pagbalik nagpakita kon pila ka target nga format specifiers ang natagbaw, o -1 kon ang format string nasayop. Ang kompleto nga diskusyon niini nga function anaa sa Paggamit sa Formatting ug Scanning Functions nga seksyon sa ulahi niini nga kapitulo.

LabWindows/CVI Standard Libraries

2-24

Kapitulo 2

Pag-format ug I/O Library

I-scanFile
int n = I-scanFile (int filePagdumala, char *formatString, targetptr1,…,targetptrn);
Katuyoan
Nagbuhat sa parehas nga sukaranan nga operasyon sama sa Scan function, gawas nga ang gigikanan nga materyal makuha gikan sa file gitumong sa filePagdumala sa argumento, nga makuha pinaagi sa pagtawag sa LabWindows/CVI function OpenFile.
Parameter

Input nga Paghatag

filePagdumala sa formatString targetptr1,…,targetptrn

Integer. String. Ang mga tipo kinahanglang motakdo sa mga sulod sa formatString.

Ibalik nga Bili

integer Gidaghanon sa target nga format

natagbaw ang mga specifier.

Ibalik ang mga Kodigo

-1

Sayop sa pag-format sa string.

-2

I/O sayop.

Gamit Kini nga Function
Ang gidaghanon sa datos nga nabasa gikan sa file depende sa kantidad nga gikinahanglan aron matuman ang mga format sa format nga string. Ang return value nagpakita kon pila ka target format specifiers ang natagbaw, -1 kon ang format string kay sayop, o -2 kon adunay I/O error. Ang usa ka kompleto nga paghisgot niini nga function anaa sa Paggamit sa Formatting ug Scanning Functions seksyon sa ulahi niini nga kapitulo.

ScanIn
int n = ScanIn (char *formatString, targetptr1,…,targetptrn);
Katuyoan
Nagbuhat sa parehas nga sukaranan nga operasyon sama sa ScanFile function, gawas nga ang tinubdan nga materyal nakuha gikan sa STDIN.

2-25

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Parameter

Input nga Paghatag

formatString targetptr1,…,targetptrn

String. Ang mga tipo kinahanglang motakdo sa mga sulod sa formatString.

Ibalik nga Bili

integer Gidaghanon sa target nga format

natagbaw ang mga specifier.

Ibalik ang mga Kodigo

-1

Sayop sa pag-format sa string.

-2

I/O sayop.

Gamit Kini nga Function
Walay argumento nga gikinahanglan alang sa tinubdan nga butang sa kaso sa ScanIn function. Ang return value nagpakita kon pila ka target format specifiers ang natagbaw, -1 kon ang format string kay sayop, o -2 kon adunay I/O error. Ang usa ka kompleto nga paghisgot niini nga function anaa sa Paggamit sa Formatting ug Scanning Functions seksyon sa ulahi niini nga kapitulo.

GitakdaFileSi Ptr
taas nga posisyon = SetFilePtr (int filePagdumala, taas nga offset, int gigikanan); Katuyoan Nagpalihok sa file pointer alang sa file gipiho sa filePagdumala sa usa ka lokasyon nga gi-offset ang mga byte gikan sa gigikanan. Ibalik ang offset sa bag-o file posisyon sa pointer gikan sa sinugdanan sa file. Parameter

Input

filePagdumala sa offset nga gigikanan

integer long integer integer

File gunitanan gibalik ni OpenFile.
Gidaghanon sa mga byte gikan sa gigikanan hangtod sa posisyon sa file itudlo.
Posisyon sa file diin gikan sa base offset.

LabWindows/CVI Standard Libraries

2-26

Kapitulo 2

Pag-format ug I/O Library

Ibalik nga Bili

posisyon

taas nga integer

Offset sa bag-o file posisyon sa pointer gikan sa sinugdanan sa file.

Ibalik ang Code

-1

Sayop tungod sa usa ka dili balido file gunitanan, usa ka dili balido nga gigikanan

bili, o usa ka offset nga bili nga sa wala pa ang sinugdanan

sa file.

Panaghisgot sa Parametro
Ang balido nga mga bili sa gigikanan mao ang mosunod:
· 0 = sinugdanan sa file
· 1 = kasamtangan nga posisyon sa file itudlo
· 2 = katapusan sa file
Gamit Kini nga Function
Kini nga function mahimo usab nga gamiton aron makuha ang file gidak-on pinaagi sa pag-set offset ngadto sa 0 ug gigikanan ngadto sa 2. Sa kini nga kaso, ang pagbalik nga bili nagpakita sa file gidak-on ug ang pointer anaa sa katapusan sa file.
Posible nga ibutang ang posisyon sa file pointer lapas sa katapusan sa file. Intermediate bytes (bytes tali sa daan nga katapusan sa file ug ang bag-ong katapusan sa file) adunay dili matino nga mga kantidad. Usa ka pagsulay sa pagpahimutang sa file pointer sa wala pa magsugod ang file hinungdan nga ang function mobalik sa usa ka sayup.
Kung ang file mao ang usa ka himan nga dili mosuporta sa random nga pag-access (sama sa standard input), ang function mibalik sa usa ka dili matino nga bili.
Example
/* Ablihi o buhata ang file c:TEST.DAT, ibalhin ang 10 bytes sa file, ug pagsulat og pisi sa file. */
/* Mubo nga sulat: Gamita \ sa pathname sa C imbes sa . */ int gunitanan, resulta; taas nga posisyon; kuptanan = BukasFile(“c:\TEST.DAT”, 0, 2, 1); kon (paggunit == -1){
FmtOut("sayop sa pagbukas file”); paggawas(1); } posisyon = SetFilePtr(gunitanan, 10L, 0); kon (posisyon == 10) {

2-27

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library
resulta = IsulatFile(kupot, “Hello, World!”, 13); kung (resulta == -1)
FmtOut("sayup sa pagsulat sa file”); } uban pa
FmtOut("pagbutang sa sayop file pointer"); Suod ngaFile(gunitan);

Kapitulo 2

StringLength
int n = StringLength (char *string); Katuyoan Ibalik ang gidaghanon sa mga byte sa string sa wala pa ang unang ASCII NUL. Parameter

Input

hilo

String.

Ibalik nga Bili

integer

Gidaghanon sa mga byte sa string

sa wala pa ang ASCII NUL.

Example
char s[100]; int nbytes; nbytes = StringLength (s);

StringLowerCase
void StringLowerCase (char string []); Katuyoan Gi-convert ang tanang dagkong letra nga alpabetikong karakter sa NUL-terminated string ngadto sa lowercase. Parameter

Input/Output string

String.

LabWindows/CVI Standard Libraries

2-28

Kapitulo 2
Ibalik nga Bili Wala

Pag-format ug I/O Library

StringUpperCase
walay sulod StringUpperCase (char string []); Katuyoan Pag-convert sa tanang lowercase nga alpabetikong karakter sa NUL-terminated string ngadto sa uppercase. Parameter

Input/Output string

String.

Ibalik nga Bili Wala

IsulatFile
int n = IsulatFile (int filePaggunit, char *buffer, unsigned int count);
Katuyoan
Nagsulat hangtod sa pag-ihap sa mga byte sa datos gikan sa buffer hangtod sa a file o sa STDOUT. Ang pagsulat magsugod sa kasamtangan nga posisyon sa file pointer, ug kung makompleto ang function, ang file Ang pointer gidugangan sa gidaghanon sa mga byte nga gisulat.
Parameter

Input

filePagdumala sa ihap sa buffer

integer string integer

File gunitanan. Buffer sa datos. Gidaghanon sa mga byte nga isulat.

Ibalik nga Bili

integer

Gidaghanon sa mga byte nga gisulat sa

file.

2-29

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

Balik Code -1

Sayop.

Panaghisgot sa Parametro
fileAng gunitanan mao ang file gunitanan nga gibalik gikan sa OpenFile function. Kung fileHandle=1, ang datos kay gisulat sa STDOUT ug walay nauna nga OpenFile gikinahanglan ang tawag.
buffer mao ang buffer nga gikan sa pagsulat data.
ang ihap nagtino sa gidaghanon sa mga byte nga isulat. Ang parameter sa pag-ihap nag-override sa gidak-on sa buffer sa pagtino sa gidaghanon sa mga byte nga isulat. Ang mga buffer nga adunay sulud nga NUL byte gisulat sa tibuuk. ang ihap kinahanglan dili molapas sa gidak-on sa buffer.
Gamit Kini nga Function
Alang sa files giablihan sa ASCII mode, ang matag karakter sa LF gipulihan sa kombinasyon sa CR-LF sa output. Sa kini nga kaso, ang kantidad sa pagbalik wala maglakip sa karakter sa CR nga gisulat sa output.
Ang usa ka sayup mahimong magpakita sa usa ka dili maayo file pagdumala, usa ka pagsulay sa pag-access sa usa ka gipanalipdan file, usa ka pagsulay sa pagsulat sa a file giablihan isip ReadOnly, o wala nay espasyo nga nahabilin sa disk.

Linya sa Pagsulat
int n = WriteLine (int filePagdumala, char *lineBuffer, int numberofBytes); Katuyoan Pagsulat sa gidaghanon saBytes bytes gikan sa lineBuffer ngadto sa a file ug dayon nagsulat ug linefeed sa file. Parameter

Input

filePagdumala sa lineBuffer numberofBytes

integer string integer

File gunitanan. Buffer sa datos. Gidaghanon sa mga byte nga isulat.

Ibalik nga Bili

integer

Gidaghanon sa mga byte nga gisulat.

lakip ang line feed.

LabWindows/CVI Standard Libraries

2-30

Kapitulo 2

Pag-format ug I/O Library

Ibalik ang Code

-1

I/O sayop.

Panaghisgot sa Parametro
Kung ang numero saBytes kay -1, ang mga byte lang sa lineBuffer sa wala pa ang unang ASCII NUL ang masulat, gisundan sa usa ka linefeed.
fileAng gunitanan mao ang file gunitanan nga gibalik gikan sa OpenFile gimbuhaton. Ang file kinahanglan nga ablihan sa ASCII mode aron ang usa ka pagbalik sa karwahe isulat sa wala pa ang linefeed. Kung fileAng gunitanan mao ang 1, ang linya isulat sa STDOUT.
Gamit Kini nga Function
Gibalik sa WriteLine ang gidaghanon sa mga byte nga gisulat sa file, walay labot ang linefeed. Kung mahitabo ang sayup sa I/O, ang WriteLine mobalik -1.

Gamit ang mga Function sa Pag-format ug Pag-scan
Gigamit nimo ang mga function sa pag-format sa datos aron mahubad o mabag-o ang mga aytem sa datos sa ubang mga porma. Ang kasagarang mga gamit mao ang paghubad tali sa datos nga gitipigan sa gawas files ug ang mga internal nga porma nga mahimong manipulahon sa programa, o aron ma-reformat ang langyaw nga binary nga representasyon ngadto sa usa diin ang programa mahimong molihok.
Adunay tulo ka mga subclass sa data formatting functions sa LabWindows/CVI Formatting ug I/O Library:
· Mga gimbuhaton sa pag-format
· Mga gimbuhaton sa pag-scan
· Mga gimbuhaton sa kahimtang
Gigamit nimo ang mga function sa pag-format aron makombinar ug ma-format ang usa o daghan pa nga gigikanan nga mga butang ngadto sa usa ka target nga butang, ug imong gigamit ang mga function sa pag-scan aron mabungkag ang usa ka gigikanan nga butang sa daghang mga target nga butang. Ang mga function sa status nagbalik sa kasayuran bahin sa kalampusan o kapakyasan sa pag-format o pag-scan nga mga gimbuhaton.
Introductory Formatting ug Scanning Examples
Aron ipaila kanimo ang mga gimbuhaton sa pag-format ug pag-scan, hunahunaa ang mosunod nga examples.

2-31

LabWindows/CVI Standard Libraries

Pag-format ug I/O Library

Kapitulo 2

I-convert ang integer value 23 ngadto sa representasyon sa ASCII ug ibutang ang sulod sa string variable:
char a[5]; int b,n; b = 23; n = Fmt (a, “%s<%i”, b);
Human sa tawag sa Fmt, ang a naglangkob sa string 23.
Niining example, a mao ang target nga argumento, b mao ang tinubdan nga argumento, ug ang string %s<%i mao ang format string. Ang Fmt nga tawag naggamit sa format nga string aron mahibal-an kung unsaon pag-convert ang tinubdan nga argumento ngadto sa target nga argumento.
Uban sa Scan function, mahimo nimong i-convert ang string 23 ngadto sa integer:
char *a; a = “23”; n = I-scan (a$, “%s>%i”, b%);
Human sa tawag sa Scan, b = 23.
Niining example, a mao ang tinubdan nga argumento, b ang target nga argumento, ug %s>%i ang format nga string.

Mga Dokumento / Mga Kapanguhaan

NATIONAL INSTRUMENTS 320682 Lab Windows Standard Libraries [pdf] Manwal sa Gumagamit
320682 Lab Windows Standard Libraries, 320682, Lab Windows Standard Libraries, Windows Standard Libraries, Standard Libraries, Libraries

Mga pakisayran

Manwal sa Gumagamit

NATIONAL INSTRUMENTS 320682 Lab Windows Standard Libraries

Mga detalye

Impormasyon sa Produkto

Mga Instruksyon sa Paggamit sa Produkto

Mga FAQ

Garantiya

Mahitungod Niini nga Manwal

ANSI C Library

Pag-format ug I/O Library

Mga Dokumento / Mga Kapanguhaan

Mga pakisayran

Pagbilin ug komento

Cancel reply