Siebel eScript Language Reference > C Language Library Reference > Clib File Input and Output Methods >

Clib Write to File Method

The Clib Write to File method writes data to a file. It returns one of the following values:

• If successful, then it returns the number of elements it wrote
• If not successful, then it returns the following value:

  0

Siebel eScript usage of fwrite differs from the standard C library usage. The C library writes arrays of numeric values or structures from consecutive bytes in memory. This is not necessarily true in Siebel eScript.

Format A

Clib.fwrite(sourceVar, varDescription, filePointer)

Format B

Clib.fwrite(sourceVar, bytelength, filePointer)

Arguments

Table 151 describes the arguments for the Clib Write to File method.

Usage for the varDescription Argument

Table 152 describes values you must set for the sourceVar argument and the varDescription argument. For example, if you use the sourceVar argument to identify a buffer, then you must set the varDescription argument to the length of that buffer, in bytes.

Example

The following example writes the following data into the fp file:

• The 16-bit i integer
• The 32-bit f float
• The 10-byte buf buffer:

  if ( !Clib.fwrite(i, SWORD16, fp) || !Clib.fwrite(f, FLOAT32, fp)
              || 10 != fwrite(buf, 10, fp))
  {
     TheApplication().RaiseErrorText("Error writing to file.\n");
  }