関数 NF_SYNC はメモリ内バッファとNetCDFファイルのディスク上コピーとを同期させる方法を提供します。 書き込み後に、同期させたい理由としては2つ挙げられます。
書き込まれた直後から 他の処理においてデータを アクセス可能にする。しかしながら、既にファイルを開いている処理に関しては、書き込み処理がNF_SYNCを呼び出すときに記録数が増加していることを感知できないことに注意してください。その処理が記録数の増加を感知するためには、読み取り処理が NF_SYNCを呼び出さなくてはなりません。
この関数はNetCDFライブラリ以前のバージョンと後方互換性があります。その目的は、一つのNetCDFファイルを複数の読者と一人の作成者の間で共有可能にすることにあります。作成者は書き込み後に NF_SYNC を呼び出し、読者は読み取る前に毎回 NF_SYNC を呼び出します。作成者側では、この操作によってバッファされているものが全てディスク上に移動します。読者側では、この操作によって次に読み取られる記録が以前にキャッシュされたバッファからではなく、ディスクからの読み取りであることが保証されます。これによって、読者はファイルを閉じて新たに開くことなく、書込み操作によって加えられた変更を見ることが出来ます(例えば書き込まれた記録数)。わずかなデータ量をアクセスする場合には、書き込み後にいちいちディスクと同期させることは、バッファすることの有用性を手放すことになり、コンピュータ資源のコストを上げてしまいます。
共有を簡単にするために(そして推奨される方法は)、作成者、読者共にファイルを NF_SHARE フラグを立てて開くことです。そうすれば NF_SYNC を呼び出す必要は 全くなくなります。しかし、 異なる処理間において少数のNetCDFアクセスのみを同期させる場合には、 NF_SYNC 関数はNF_SHAREフラグよりも より細かい粒度を持ちます。
従属的なデータ(属性値など)に加えられた変更にも注意する必要があります。これらは NF_SHAREフラグによっては自動的に伝達されません。このためには NF_SYNC 関数を使わなければなりません。
作成者がデータの設計を変えるために定義モードに入った時にファイルを共有する場合は特に注意しなくてはなりません。以前のバージョンでは、作成者が定義モードを抜けると、変更は新ファイルに加えられたために、読者は旧ファイルを参照したままでした。読者が変更を見るためにはファイルを一度閉じて開きなおさなければなりませんでした。 それによって、変更されたファイルが手元にあっても、読者側の内部テーブルが新しいファイルの設計と一致していないことには読者には伝わりません。再定義後にもNetCDFファイルが共有されるためには、再定義中に読者がデータにアクセスするのを防ぎ、次にアクセスする前に読者に NF_SYNC を呼び出させる 、何らかのNetCDFライブラリ外のメカニズムが必要になります。
NF_SYNC を呼び出すとき、NetCDFファイルは データモードになくてはなりません。定義モードのNetCDFファイルは NF_ENDDEF が呼び出されたときにのみディスクと同期します。他の処理によって書き込まれているNetCDFファイルを読み取る処理は NF_SYNC を呼び出すことによって 、ファイルを閉じて再度開くことなく、書き込み処理によって変えられた最新の変更(例えば、書かれた記録数)に関する情報を得られます。
NetCDFファイルを閉じた時、又は定義モードから抜けるたびに、データは 自動的にディスクと同期します。
この 例では NF_SYNC を使って、 foo.nc というNetCDFファイルのディスク書き込みを同期させます。
INCLUDE 'netcdf.inc'
...
INTEGER STATUS, NCID
...
STATUS = NF_OPEN('foo.nc', NF_WRITE, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
...
! データを書き込む、又は属性を変更する
...
STATUS = NF_SYNC(NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)