**Inheritance:**
java.lang.Object, [com.aspose.words.Field](../../com.aspose.words/field/)
```
public class FieldSymbol extends Field
```

Implements a SYMBOL field.

To learn more, visit the [ Working with Fields ][Working with Fields] documentation article.

 **Remarks:** 

Retrieves the character whose code point value is specified in decimal or hexadecimal.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```


[Working with Fields]: https://docs.aspose.com/words/java/working-with-fields/
## Methods

| Method | Description |
| --- | --- |
| [getCharacterCode()](#getCharacterCode) | Gets the character's code point value in decimal or hexadecimal. |
| [getDisplayResult()](#getDisplayResult) | Gets the text that represents the displayed field result. |
| [getDontAffectsLineSpacing()](#getDontAffectsLineSpacing) | Gets whether the character retrieved by the field affects the line spacing of the paragraph. |
| [getEnd()](#getEnd) | Gets the node that represents the field end. |
| [getFieldCode()](#getFieldCode) | Returns text between field start and field separator (or field end if there is no separator). |
| [getFieldCode(boolean includeChildFieldCodes)](#getFieldCode-boolean) | Returns text between field start and field separator (or field end if there is no separator). |
| [getFontName()](#getFontName) | Gets the name of the font of the character retrieved by the field. |
| [getFontSize()](#getFontSize) | Gets the size in points of the font of the character retrieved by the field. |
| [getFormat()](#getFormat) | Gets a [FieldFormat](../../com.aspose.words/fieldformat/) object that provides typed access to field's formatting. |
| [getLocaleId()](#getLocaleId) | Gets the LCID of the field. |
| [getResult()](#getResult) | Gets text that is between the field separator and field end. |
| [getSeparator()](#getSeparator) | Gets the node that represents the field separator. |
| [getStart()](#getStart) | Gets the node that represents the start of the field. |
| [getSwitchType(String switchName)](#getSwitchType-java.lang.String) |  |
| [getType()](#getType) | Gets the Microsoft Word field type. |
| [isAnsi()](#isAnsi) | Gets whether the character code is interpreted as the value of an ANSI character. |
| [isAnsi(boolean value)](#isAnsi-boolean) | Sets whether the character code is interpreted as the value of an ANSI character. |
| [isDirty()](#isDirty) | Gets whether the current result of the field is no longer correct (stale) due to other modifications made to the document. |
| [isDirty(boolean value)](#isDirty-boolean) | Sets whether the current result of the field is no longer correct (stale) due to other modifications made to the document. |
| [isLocked()](#isLocked) | Gets whether the field is locked (should not recalculate its result). |
| [isLocked(boolean value)](#isLocked-boolean) | Sets whether the field is locked (should not recalculate its result). |
| [isShiftJis()](#isShiftJis) | Gets whether the character code is interpreted as the value of a SHIFT-JIS character. |
| [isShiftJis(boolean value)](#isShiftJis-boolean) | Sets whether the character code is interpreted as the value of a SHIFT-JIS character. |
| [isUnicode()](#isUnicode) | Gets whether the character code is interpreted as the value of a Unicode character. |
| [isUnicode(boolean value)](#isUnicode-boolean) | Sets whether the character code is interpreted as the value of a Unicode character. |
| [remove()](#remove) | Removes the field from the document. |
| [setCharacterCode(String value)](#setCharacterCode-java.lang.String) | Sets the character's code point value in decimal or hexadecimal. |
| [setDontAffectsLineSpacing(boolean value)](#setDontAffectsLineSpacing-boolean) | Sets whether the character retrieved by the field affects the line spacing of the paragraph. |
| [setFontName(String value)](#setFontName-java.lang.String) | Sets the name of the font of the character retrieved by the field. |
| [setFontSize(String value)](#setFontSize-java.lang.String) | Sets the size in points of the font of the character retrieved by the field. |
| [setLocaleId(int value)](#setLocaleId-int) | Sets the LCID of the field. |
| [setResult(String value)](#setResult-java.lang.String) | Sets text that is between the field separator and field end. |
| [unlink()](#unlink) | Performs the field unlink. |
| [update()](#update) | Performs the field update. |
| [update(boolean ignoreMergeFormat)](#update-boolean) | Performs a field update. |
### getCharacterCode() {#getCharacterCode}
```
public String getCharacterCode()
```


Gets the character's code point value in decimal or hexadecimal.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
java.lang.String - The character's code point value in decimal or hexadecimal.
### getDisplayResult() {#getDisplayResult}
```
public String getDisplayResult()
```


Gets the text that represents the displayed field result.

 **Remarks:** 

The [Document.updateListLabels()](../../com.aspose.words/document/\#updateListLabels) method must be called to obtain correct value for the [FieldListNum](../../com.aspose.words/fieldlistnum/), [FieldAutoNum](../../com.aspose.words/fieldautonum/), [FieldAutoNumOut](../../com.aspose.words/fieldautonumout/) and [FieldAutoNumLgl](../../com.aspose.words/fieldautonumlgl/) fields.

 **Examples:** 

Shows how to get the real text that a field displays in the document.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 builder.write("This document was written by ");
 FieldAuthor fieldAuthor = (FieldAuthor) builder.insertField(FieldType.FIELD_AUTHOR, true);
 fieldAuthor.setAuthorName("John Doe");

 // We can use the DisplayResult property to verify what exact text
 // a field would display in its place in the document.
 Assert.assertEquals("", fieldAuthor.getDisplayResult());

 // Fields do not maintain accurate result values in real-time.
 // To make sure our fields display accurate results at any given time,
 // such as right before a save operation, we need to update them manually.
 fieldAuthor.update();

 Assert.assertEquals("John Doe", fieldAuthor.getDisplayResult());

 doc.save(getArtifactsDir() + "Field.DisplayResult.docx");
 
```

**Returns:**
java.lang.String - The text that represents the displayed field result.
### getDontAffectsLineSpacing() {#getDontAffectsLineSpacing}
```
public boolean getDontAffectsLineSpacing()
```


Gets whether the character retrieved by the field affects the line spacing of the paragraph.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
boolean - Whether the character retrieved by the field affects the line spacing of the paragraph.
### getEnd() {#getEnd}
```
public FieldEnd getEnd()
```


Gets the node that represents the field end.

 **Examples:** 

Shows how to work with a collection of fields.

```

 public void fieldCollection() throws Exception {
     Document doc = new Document();
     DocumentBuilder builder = new DocumentBuilder(doc);

     builder.insertField(" DATE \\@ \"dddd, d MMMM yyyy\" ");
     builder.insertField(" TIME ");
     builder.insertField(" REVNUM ");
     builder.insertField(" AUTHOR  \"John Doe\" ");
     builder.insertField(" SUBJECT \"My Subject\" ");
     builder.insertField(" QUOTE \"Hello world!\" ");
     doc.updateFields();

     FieldCollection fields = doc.getRange().getFields();

     Assert.assertEquals(6, fields.getCount());

     // Iterate over the field collection, and print contents and type
     // of every field using a custom visitor implementation.
     FieldVisitor fieldVisitor = new FieldVisitor();

     Iterator fieldEnumerator = fields.iterator();

     while (fieldEnumerator.hasNext()) {
         if (fieldEnumerator != null) {
             Field currentField = fieldEnumerator.next();

             currentField.getStart().accept(fieldVisitor);
             if (currentField.getSeparator() != null) {
                 currentField.getSeparator().accept(fieldVisitor);
             }
             currentField.getEnd().accept(fieldVisitor);
         } else {
             System.out.println("There are no fields in the document.");
         }
     }

     System.out.println(fieldVisitor.getText());
 }

 /// 
 /// Document visitor implementation that prints field info.
 /// 
 public static class FieldVisitor extends DocumentVisitor {
     public FieldVisitor() {
         mBuilder = new StringBuilder();
     }

     /// 
     /// Gets the plain text of the document that was accumulated by the visitor.
     /// 
     public String getText() {
         return mBuilder.toString();
     }

     /// 
     /// Called when a FieldStart node is encountered in the document.
     /// 
     public int visitFieldStart(final FieldStart fieldStart) {
         mBuilder.append("Found field: " + fieldStart.getFieldType() + "\r\n");
         mBuilder.append("\tField code: " + fieldStart.getField().getFieldCode() + "\r\n");
         mBuilder.append("\tDisplayed as: " + fieldStart.getField().getResult() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldSeparator node is encountered in the document.
     /// 
     public int visitFieldSeparator(final FieldSeparator fieldSeparator) {
         mBuilder.append("\tFound separator: " + fieldSeparator.getText() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldEnd node is encountered in the document.
     /// 
     public int visitFieldEnd(final FieldEnd fieldEnd) {
         mBuilder.append("End of field: " + fieldEnd.getFieldType() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     private final  StringBuilder mBuilder;
 }
 
```

**Returns:**
[FieldEnd](../../com.aspose.words/fieldend/) - The node that represents the field end.
### getFieldCode() {#getFieldCode}
```
public String getFieldCode()
```


Returns text between field start and field separator (or field end if there is no separator). Both field code and field result of child fields are included.

 **Examples:** 

Shows how to insert a field into a document using a field code.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 Field dateField = builder.insertField("DATE \\* MERGEFORMAT");

 Assert.assertEquals(FieldType.FIELD_DATE, dateField.getType());
 Assert.assertEquals("DATE \\* MERGEFORMAT", dateField.getFieldCode());
 
```

Shows how to get a field's field code.

```

 // Open a document which contains a MERGEFIELD inside an IF field.
 Document doc = new Document(getMyDir() + "Nested fields.docx");
 FieldIf fieldIf = (FieldIf) doc.getRange().getFields().get(0);

 // There are two ways of getting a field's field code:
 // 1 -  Omit its inner fields:
 Assert.assertEquals(" IF  > 0 \" (surplus of ) \" \"\" ", fieldIf.getFieldCode(false));

 // 2 -  Include its inner fields:
 Assert.assertEquals(" IF  MERGEFIELD NetIncome  > 0 \" (surplus of  MERGEFIELD  NetIncome \\f $ ) \" \"\" ",
         fieldIf.getFieldCode(true));

 // By default, the GetFieldCode method displays inner fields.
 Assert.assertEquals(fieldIf.getFieldCode(), fieldIf.getFieldCode(true));
 
```

**Returns:**
java.lang.String
### getFieldCode(boolean includeChildFieldCodes) {#getFieldCode-boolean}
```
public String getFieldCode(boolean includeChildFieldCodes)
```


Returns text between field start and field separator (or field end if there is no separator).

 **Examples:** 

Shows how to get a field's field code.

```

 // Open a document which contains a MERGEFIELD inside an IF field.
 Document doc = new Document(getMyDir() + "Nested fields.docx");
 FieldIf fieldIf = (FieldIf) doc.getRange().getFields().get(0);

 // There are two ways of getting a field's field code:
 // 1 -  Omit its inner fields:
 Assert.assertEquals(" IF  > 0 \" (surplus of ) \" \"\" ", fieldIf.getFieldCode(false));

 // 2 -  Include its inner fields:
 Assert.assertEquals(" IF  MERGEFIELD NetIncome  > 0 \" (surplus of  MERGEFIELD  NetIncome \\f $ ) \" \"\" ",
         fieldIf.getFieldCode(true));

 // By default, the GetFieldCode method displays inner fields.
 Assert.assertEquals(fieldIf.getFieldCode(), fieldIf.getFieldCode(true));
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| includeChildFieldCodes | boolean |  true  if child field codes should be included. |

**Returns:**
java.lang.String
### getFontName() {#getFontName}
```
public String getFontName()
```


Gets the name of the font of the character retrieved by the field.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
java.lang.String - The name of the font of the character retrieved by the field.
### getFontSize() {#getFontSize}
```
public String getFontSize()
```


Gets the size in points of the font of the character retrieved by the field.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
java.lang.String - The size in points of the font of the character retrieved by the field.
### getFormat() {#getFormat}
```
public FieldFormat getFormat()
```


Gets a [FieldFormat](../../com.aspose.words/fieldformat/) object that provides typed access to field's formatting.

 **Examples:** 

Shows how to format field results.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Use a document builder to insert a field that displays a result with no format applied.
 Field field = builder.insertField("= 2 + 3");

 Assert.assertEquals("= 2 + 3", field.getFieldCode());
 Assert.assertEquals("5", field.getResult());

 // We can apply a format to a field's result using the field's properties.
 // Below are three types of formats that we can apply to a field's result.
 // 1 -  Numeric format:
 FieldFormat format = field.getFormat();
 format.setNumericFormat("$###.00");
 field.update();

 Assert.assertEquals("= 2 + 3 \\# $###.00", field.getFieldCode());
 Assert.assertEquals("$  5.00", field.getResult());

 // 2 -  Date/time format:
 field = builder.insertField("DATE");
 format = field.getFormat();
 format.setDateTimeFormat("dddd, MMMM dd, yyyy");
 field.update();

 Assert.assertEquals("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.getFieldCode());
 System.out.println("Today's date, in {format.DateTimeFormat} format:\n\t{field.Result}");

 // 3 -  General format:
 field = builder.insertField("= 25 + 33");
 format = field.getFormat();
 format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
 format.getGeneralFormats().add(GeneralFormat.UPPER);
 field.update();

 int index = 0;
 Iterator generalFormatEnumerator = format.getGeneralFormats().iterator();
 while (generalFormatEnumerator.hasNext()) {
     int value = generalFormatEnumerator.next();
     System.out.println(MessageFormat.format("General format index {0}: {1}", index++, value));
 }

 Assert.assertEquals("= 25 + 33 \\* roman \\* Upper", field.getFieldCode());
 Assert.assertEquals("LVIII", field.getResult());
 Assert.assertEquals(2, format.getGeneralFormats().getCount());
 Assert.assertEquals(GeneralFormat.LOWERCASE_ROMAN, format.getGeneralFormats().get(0));

 // We can remove our formats to revert the field's result to its original form.
 format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
 format.getGeneralFormats().removeAt(0);
 Assert.assertEquals(0, format.getGeneralFormats().getCount());
 field.update();

 Assert.assertEquals("= 25 + 33  ", field.getFieldCode());
 Assert.assertEquals("58", field.getResult());
 Assert.assertEquals(0, format.getGeneralFormats().getCount());
 
```

**Returns:**
[FieldFormat](../../com.aspose.words/fieldformat/) - A [FieldFormat](../../com.aspose.words/fieldformat/) object that provides typed access to field's formatting.
### getLocaleId() {#getLocaleId}
```
public int getLocaleId()
```


Gets the LCID of the field.

 **Examples:** 

Shows how to insert a field and work with its locale.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Insert a DATE field, and then print the date it will display.
 // Your thread's current culture determines the formatting of the date.
 Field field = builder.insertField("DATE");
 System.out.println(MessageFormat.format("Today''s date, as displayed in the \"{0}\" culture: {1}", Locale.getDefault().getDisplayLanguage(), field.getResult()));

 Assert.assertEquals(1033, field.getLocaleId());
 // Changing the culture of our thread will impact the result of the DATE field.
 // Another way to get the DATE field to display a date in a different culture is to use its LocaleId property.
 // This way allows us to avoid changing the thread's culture to get this effect.
 doc.getFieldOptions().setFieldUpdateCultureSource(FieldUpdateCultureSource.FIELD_CODE);
 CultureInfo de = new CultureInfo("de-DE");
 field.setLocaleId(1031);
 field.update();

 System.out.println(MessageFormat.format("Today''s date, as displayed according to the \"{0}\" culture: {1}", Locale.forLanguageTag(LocaleUtil.getLocaleFromLCID(field.getLocaleId())).getDisplayLanguage(), field.getResult()));
 
```

**Returns:**
int - The LCID of the field.
### getResult() {#getResult}
```
public String getResult()
```


Gets text that is between the field separator and field end.

 **Examples:** 

Shows how to insert a field into a document using a field code.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 Field dateField = builder.insertField("DATE \\* MERGEFORMAT");

 Assert.assertEquals(FieldType.FIELD_DATE, dateField.getType());
 Assert.assertEquals("DATE \\* MERGEFORMAT", dateField.getFieldCode());
 
```

**Returns:**
java.lang.String - Text that is between the field separator and field end.
### getSeparator() {#getSeparator}
```
public FieldSeparator getSeparator()
```


Gets the node that represents the field separator. Can be  null .

 **Examples:** 

Shows how to work with a collection of fields.

```

 public void fieldCollection() throws Exception {
     Document doc = new Document();
     DocumentBuilder builder = new DocumentBuilder(doc);

     builder.insertField(" DATE \\@ \"dddd, d MMMM yyyy\" ");
     builder.insertField(" TIME ");
     builder.insertField(" REVNUM ");
     builder.insertField(" AUTHOR  \"John Doe\" ");
     builder.insertField(" SUBJECT \"My Subject\" ");
     builder.insertField(" QUOTE \"Hello world!\" ");
     doc.updateFields();

     FieldCollection fields = doc.getRange().getFields();

     Assert.assertEquals(6, fields.getCount());

     // Iterate over the field collection, and print contents and type
     // of every field using a custom visitor implementation.
     FieldVisitor fieldVisitor = new FieldVisitor();

     Iterator fieldEnumerator = fields.iterator();

     while (fieldEnumerator.hasNext()) {
         if (fieldEnumerator != null) {
             Field currentField = fieldEnumerator.next();

             currentField.getStart().accept(fieldVisitor);
             if (currentField.getSeparator() != null) {
                 currentField.getSeparator().accept(fieldVisitor);
             }
             currentField.getEnd().accept(fieldVisitor);
         } else {
             System.out.println("There are no fields in the document.");
         }
     }

     System.out.println(fieldVisitor.getText());
 }

 /// 
 /// Document visitor implementation that prints field info.
 /// 
 public static class FieldVisitor extends DocumentVisitor {
     public FieldVisitor() {
         mBuilder = new StringBuilder();
     }

     /// 
     /// Gets the plain text of the document that was accumulated by the visitor.
     /// 
     public String getText() {
         return mBuilder.toString();
     }

     /// 
     /// Called when a FieldStart node is encountered in the document.
     /// 
     public int visitFieldStart(final FieldStart fieldStart) {
         mBuilder.append("Found field: " + fieldStart.getFieldType() + "\r\n");
         mBuilder.append("\tField code: " + fieldStart.getField().getFieldCode() + "\r\n");
         mBuilder.append("\tDisplayed as: " + fieldStart.getField().getResult() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldSeparator node is encountered in the document.
     /// 
     public int visitFieldSeparator(final FieldSeparator fieldSeparator) {
         mBuilder.append("\tFound separator: " + fieldSeparator.getText() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldEnd node is encountered in the document.
     /// 
     public int visitFieldEnd(final FieldEnd fieldEnd) {
         mBuilder.append("End of field: " + fieldEnd.getFieldType() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     private final  StringBuilder mBuilder;
 }
 
```

**Returns:**
[FieldSeparator](../../com.aspose.words/fieldseparator/) - The node that represents the field separator.
### getStart() {#getStart}
```
public FieldStart getStart()
```


Gets the node that represents the start of the field.

 **Examples:** 

Shows how to work with a collection of fields.

```

 public void fieldCollection() throws Exception {
     Document doc = new Document();
     DocumentBuilder builder = new DocumentBuilder(doc);

     builder.insertField(" DATE \\@ \"dddd, d MMMM yyyy\" ");
     builder.insertField(" TIME ");
     builder.insertField(" REVNUM ");
     builder.insertField(" AUTHOR  \"John Doe\" ");
     builder.insertField(" SUBJECT \"My Subject\" ");
     builder.insertField(" QUOTE \"Hello world!\" ");
     doc.updateFields();

     FieldCollection fields = doc.getRange().getFields();

     Assert.assertEquals(6, fields.getCount());

     // Iterate over the field collection, and print contents and type
     // of every field using a custom visitor implementation.
     FieldVisitor fieldVisitor = new FieldVisitor();

     Iterator fieldEnumerator = fields.iterator();

     while (fieldEnumerator.hasNext()) {
         if (fieldEnumerator != null) {
             Field currentField = fieldEnumerator.next();

             currentField.getStart().accept(fieldVisitor);
             if (currentField.getSeparator() != null) {
                 currentField.getSeparator().accept(fieldVisitor);
             }
             currentField.getEnd().accept(fieldVisitor);
         } else {
             System.out.println("There are no fields in the document.");
         }
     }

     System.out.println(fieldVisitor.getText());
 }

 /// 
 /// Document visitor implementation that prints field info.
 /// 
 public static class FieldVisitor extends DocumentVisitor {
     public FieldVisitor() {
         mBuilder = new StringBuilder();
     }

     /// 
     /// Gets the plain text of the document that was accumulated by the visitor.
     /// 
     public String getText() {
         return mBuilder.toString();
     }

     /// 
     /// Called when a FieldStart node is encountered in the document.
     /// 
     public int visitFieldStart(final FieldStart fieldStart) {
         mBuilder.append("Found field: " + fieldStart.getFieldType() + "\r\n");
         mBuilder.append("\tField code: " + fieldStart.getField().getFieldCode() + "\r\n");
         mBuilder.append("\tDisplayed as: " + fieldStart.getField().getResult() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldSeparator node is encountered in the document.
     /// 
     public int visitFieldSeparator(final FieldSeparator fieldSeparator) {
         mBuilder.append("\tFound separator: " + fieldSeparator.getText() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     /// 
     /// Called when a FieldEnd node is encountered in the document.
     /// 
     public int visitFieldEnd(final FieldEnd fieldEnd) {
         mBuilder.append("End of field: " + fieldEnd.getFieldType() + "\r\n");

         return VisitorAction.CONTINUE;
     }

     private final  StringBuilder mBuilder;
 }
 
```

**Returns:**
[FieldStart](../../com.aspose.words/fieldstart/) - The node that represents the start of the field.
### getSwitchType(String switchName) {#getSwitchType-java.lang.String}
```
public int getSwitchType(String switchName)
```




**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| switchName | java.lang.String |  |

**Returns:**
int
### getType() {#getType}
```
public int getType()
```


Gets the Microsoft Word field type.

 **Examples:** 

Shows how to insert a field into a document using a field code.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 Field dateField = builder.insertField("DATE \\* MERGEFORMAT");

 Assert.assertEquals(FieldType.FIELD_DATE, dateField.getType());
 Assert.assertEquals("DATE \\* MERGEFORMAT", dateField.getFieldCode());
 
```

**Returns:**
int - The Microsoft Word field type. The returned value is one of [FieldType](../../com.aspose.words/fieldtype/) constants.
### isAnsi() {#isAnsi}
```
public boolean isAnsi()
```


Gets whether the character code is interpreted as the value of an ANSI character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
boolean - Whether the character code is interpreted as the value of an ANSI character.
### isAnsi(boolean value) {#isAnsi-boolean}
```
public void isAnsi(boolean value)
```


Sets whether the character code is interpreted as the value of an ANSI character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the character code is interpreted as the value of an ANSI character. |

### isDirty() {#isDirty}
```
public boolean isDirty()
```


Gets whether the current result of the field is no longer correct (stale) due to other modifications made to the document.

 **Examples:** 

Shows how to use special property for updating field result.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Give the document's built-in "Author" property value, and then display it with a field.
 doc.getBuiltInDocumentProperties().setAuthor("John Doe");
 FieldAuthor field = (FieldAuthor) builder.insertField(FieldType.FIELD_AUTHOR, true);

 Assert.assertFalse(field.isDirty());
 Assert.assertEquals("John Doe", field.getResult());

 // Update the property. The field still displays the old value.
 doc.getBuiltInDocumentProperties().setAuthor("John & Jane Doe");

 Assert.assertEquals("John Doe", field.getResult());

 // Since the field's value is out of date, we can mark it as "dirty".
 // This value will stay out of date until we update the field manually with the Field.Update() method.
 field.isDirty(true);

 // If we save without calling an update method,
 // the field will keep displaying the out of date value in the output document.
 doc.save(getArtifactsDir() + "Filed.UpdateDirtyFields.docx");

 // The LoadOptions object has an option to update all fields
 // marked as "dirty" when loading the document.
 LoadOptions options = new LoadOptions();
 options.setUpdateDirtyFields(updateDirtyFields);

 doc = new Document(getArtifactsDir() + "Filed.UpdateDirtyFields.docx", options);

 Assert.assertEquals("John & Jane Doe", doc.getBuiltInDocumentProperties().getAuthor());

 field = (FieldAuthor) doc.getRange().getFields().get(0);

 // Updating dirty fields like this automatically set their "IsDirty" flag to false.
 if (updateDirtyFields) {
     Assert.assertEquals("John & Jane Doe", field.getResult());
     Assert.assertFalse(field.isDirty());
 } else {
     Assert.assertEquals("John Doe", field.getResult());
     Assert.assertTrue(field.isDirty());
 }
 
```

**Returns:**
boolean - Whether the current result of the field is no longer correct (stale) due to other modifications made to the document.
### isDirty(boolean value) {#isDirty-boolean}
```
public void isDirty(boolean value)
```


Sets whether the current result of the field is no longer correct (stale) due to other modifications made to the document.

 **Examples:** 

Shows how to use special property for updating field result.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Give the document's built-in "Author" property value, and then display it with a field.
 doc.getBuiltInDocumentProperties().setAuthor("John Doe");
 FieldAuthor field = (FieldAuthor) builder.insertField(FieldType.FIELD_AUTHOR, true);

 Assert.assertFalse(field.isDirty());
 Assert.assertEquals("John Doe", field.getResult());

 // Update the property. The field still displays the old value.
 doc.getBuiltInDocumentProperties().setAuthor("John & Jane Doe");

 Assert.assertEquals("John Doe", field.getResult());

 // Since the field's value is out of date, we can mark it as "dirty".
 // This value will stay out of date until we update the field manually with the Field.Update() method.
 field.isDirty(true);

 // If we save without calling an update method,
 // the field will keep displaying the out of date value in the output document.
 doc.save(getArtifactsDir() + "Filed.UpdateDirtyFields.docx");

 // The LoadOptions object has an option to update all fields
 // marked as "dirty" when loading the document.
 LoadOptions options = new LoadOptions();
 options.setUpdateDirtyFields(updateDirtyFields);

 doc = new Document(getArtifactsDir() + "Filed.UpdateDirtyFields.docx", options);

 Assert.assertEquals("John & Jane Doe", doc.getBuiltInDocumentProperties().getAuthor());

 field = (FieldAuthor) doc.getRange().getFields().get(0);

 // Updating dirty fields like this automatically set their "IsDirty" flag to false.
 if (updateDirtyFields) {
     Assert.assertEquals("John & Jane Doe", field.getResult());
     Assert.assertFalse(field.isDirty());
 } else {
     Assert.assertEquals("John Doe", field.getResult());
     Assert.assertTrue(field.isDirty());
 }
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the current result of the field is no longer correct (stale) due to other modifications made to the document. |

### isLocked() {#isLocked}
```
public boolean isLocked()
```


Gets whether the field is locked (should not recalculate its result).

 **Examples:** 

Shows how to work with a FieldStart node.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 FieldDate field = (FieldDate) builder.insertField(FieldType.FIELD_DATE, true);
 field.getFormat().setDateTimeFormat("dddd, MMMM dd, yyyy");
 field.update();

 FieldChar fieldStart = field.getStart();

 Assert.assertEquals(FieldType.FIELD_DATE, fieldStart.getFieldType());
 Assert.assertEquals(false, fieldStart.isDirty());
 Assert.assertEquals(false, fieldStart.isLocked());

 // Retrieve the facade object which represents the field in the document.
 field = (FieldDate) fieldStart.getField();

 Assert.assertEquals(false, field.isLocked());
 Assert.assertEquals(" DATE  \\@ \"dddd, MMMM dd, yyyy\"", field.getFieldCode());

 // Update the field to show the current date.
 field.update();
 
```

**Returns:**
boolean - Whether the field is locked (should not recalculate its result).
### isLocked(boolean value) {#isLocked-boolean}
```
public void isLocked(boolean value)
```


Sets whether the field is locked (should not recalculate its result).

 **Examples:** 

Shows how to work with a FieldStart node.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 FieldDate field = (FieldDate) builder.insertField(FieldType.FIELD_DATE, true);
 field.getFormat().setDateTimeFormat("dddd, MMMM dd, yyyy");
 field.update();

 FieldChar fieldStart = field.getStart();

 Assert.assertEquals(FieldType.FIELD_DATE, fieldStart.getFieldType());
 Assert.assertEquals(false, fieldStart.isDirty());
 Assert.assertEquals(false, fieldStart.isLocked());

 // Retrieve the facade object which represents the field in the document.
 field = (FieldDate) fieldStart.getField();

 Assert.assertEquals(false, field.isLocked());
 Assert.assertEquals(" DATE  \\@ \"dddd, MMMM dd, yyyy\"", field.getFieldCode());

 // Update the field to show the current date.
 field.update();
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the field is locked (should not recalculate its result). |

### isShiftJis() {#isShiftJis}
```
public boolean isShiftJis()
```


Gets whether the character code is interpreted as the value of a SHIFT-JIS character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
boolean - Whether the character code is interpreted as the value of a SHIFT-JIS character.
### isShiftJis(boolean value) {#isShiftJis-boolean}
```
public void isShiftJis(boolean value)
```


Sets whether the character code is interpreted as the value of a SHIFT-JIS character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the character code is interpreted as the value of a SHIFT-JIS character. |

### isUnicode() {#isUnicode}
```
public boolean isUnicode()
```


Gets whether the character code is interpreted as the value of a Unicode character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Returns:**
boolean - Whether the character code is interpreted as the value of a Unicode character.
### isUnicode(boolean value) {#isUnicode-boolean}
```
public void isUnicode(boolean value)
```


Sets whether the character code is interpreted as the value of a Unicode character.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the character code is interpreted as the value of a Unicode character. |

### remove() {#remove}
```
public Node remove()
```


Removes the field from the document. Returns a node right after the field. If the field's end is the last child of its parent node, returns its parent paragraph. If the field is already removed, returns  null .

 **Examples:** 

Shows how to remove fields from a field collection.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 builder.insertField(" DATE \\@ \"dddd, d MMMM yyyy\" ");
 builder.insertField(" TIME ");
 builder.insertField(" REVNUM ");
 builder.insertField(" AUTHOR  \"John Doe\" ");
 builder.insertField(" SUBJECT \"My Subject\" ");
 builder.insertField(" QUOTE \"Hello world!\" ");
 doc.updateFields();

 FieldCollection fields = doc.getRange().getFields();

 Assert.assertEquals(6, fields.getCount());

 // Below are four ways of removing fields from a field collection.
 // 1 -  Get a field to remove itself:
 fields.get(0).remove();
 Assert.assertEquals(5, fields.getCount());

 // 2 -  Get the collection to remove a field that we pass to its removal method:
 Field lastField = fields.get(3);
 fields.remove(lastField);
 Assert.assertEquals(4, fields.getCount());

 // 3 -  Remove a field from a collection at an index:
 fields.removeAt(2);
 Assert.assertEquals(3, fields.getCount());

 // 4 -  Remove all the fields from the collection at once:
 fields.clear();
 Assert.assertEquals(0, fields.getCount());
 
```

Shows how to process PRIVATE fields.

```

 public void fieldPrivate() throws Exception {
     // Open a Corel WordPerfect document which we have converted to .docx format.
     Document doc = new Document(getMyDir() + "Field sample - PRIVATE.docx");

     // WordPerfect 5.x/6.x documents like the one we have loaded may contain PRIVATE fields.
     // Microsoft Word preserves PRIVATE fields during load/save operations,
     // but provides no functionality for them.
     FieldPrivate field = (FieldPrivate) doc.getRange().getFields().get(0);

     Assert.assertEquals(" PRIVATE \"My value\" ", field.getFieldCode());
     Assert.assertEquals(FieldType.FIELD_PRIVATE, field.getType());

     // We can also insert PRIVATE fields using a document builder.
     DocumentBuilder builder = new DocumentBuilder(doc);
     builder.insertField(FieldType.FIELD_PRIVATE, true);

     // These fields are not a viable way of protecting sensitive information.
     // Unless backward compatibility with older versions of WordPerfect is essential,
     // we can safely remove these fields. We can do this using a DocumentVisiitor implementation.
     Assert.assertEquals(2, doc.getRange().getFields().getCount());

     FieldPrivateRemover remover = new FieldPrivateRemover();
     doc.accept(remover);

     Assert.assertEquals(remover.getFieldsRemovedCount(), 2);
     Assert.assertEquals(doc.getRange().getFields().getCount(), 0);
 }

 /// 
 /// Removes all encountered PRIVATE fields.
 /// 
 public static class FieldPrivateRemover extends DocumentVisitor {
     public FieldPrivateRemover() {
         mFieldsRemovedCount = 0;
     }

     public int getFieldsRemovedCount() {
         return mFieldsRemovedCount;
     }

     /// 
     /// Called when a FieldEnd node is encountered in the document.
     /// If the node belongs to a PRIVATE field, the entire field is removed.
     /// 
     public int visitFieldEnd(final FieldEnd fieldEnd) throws Exception {
         if (fieldEnd.getFieldType() == FieldType.FIELD_PRIVATE) {
             fieldEnd.getField().remove();
             mFieldsRemovedCount++;
         }

         return VisitorAction.CONTINUE;
     }

     private int mFieldsRemovedCount;
 }
 
```

**Returns:**
[Node](../../com.aspose.words/node/)
### setCharacterCode(String value) {#setCharacterCode-java.lang.String}
```
public void setCharacterCode(String value)
```


Sets the character's code point value in decimal or hexadecimal.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | java.lang.String | The character's code point value in decimal or hexadecimal. |

### setDontAffectsLineSpacing(boolean value) {#setDontAffectsLineSpacing-boolean}
```
public void setDontAffectsLineSpacing(boolean value)
```


Sets whether the character retrieved by the field affects the line spacing of the paragraph.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | boolean | Whether the character retrieved by the field affects the line spacing of the paragraph. |

### setFontName(String value) {#setFontName-java.lang.String}
```
public void setFontName(String value)
```


Sets the name of the font of the character retrieved by the field.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | java.lang.String | The name of the font of the character retrieved by the field. |

### setFontSize(String value) {#setFontSize-java.lang.String}
```
public void setFontSize(String value)
```


Sets the size in points of the font of the character retrieved by the field.

 **Examples:** 

Shows how to use the SYMBOL field.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Below are three ways to use a SYMBOL field to display a single character.
 // 1 -  Add a SYMBOL field which displays the © (Copyright) symbol, specified by an ANSI character code:
 FieldSymbol field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // The ANSI character code "U+00A9", or "169" in integer form, is reserved for the copyright symbol.
 field.setCharacterCode(Integer.toString(0x00a9));
 field.isAnsi(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  169 \\a");

 builder.writeln(" Line 1");

 // 2 -  Add a SYMBOL field which displays the \u221e (Infinity) symbol, and modify its appearance:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);

 // In Unicode, the infinity symbol occupies the "221E" code.
 field.setCharacterCode(Integer.toString(0x221E));
 field.isUnicode(true);

 // Change the font of our symbol after using the Windows Character Map
 // to ensure that the font can represent that symbol.
 field.setFontName("Calibri");
 field.setFontSize("24");

 // We can set this flag for tall symbols to make them not push down the rest of the text on their line.
 field.setDontAffectsLineSpacing(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  8734 \\u \\f Calibri \\s 24 \\h");

 builder.writeln("Line 2");

 // 3 -  Add a SYMBOL field which displays the \u3042 character,
 // with a font that supports Shift-JIS (Windows-932) codepage:
 field = (FieldSymbol) builder.insertField(FieldType.FIELD_SYMBOL, true);
 field.setFontName("MS Gothic");
 field.setCharacterCode(Integer.toString(0x82A0));
 field.isShiftJis(true);

 Assert.assertEquals(field.getFieldCode(), " SYMBOL  33440 \\f \"MS Gothic\" \\j");

 builder.write("Line 3");

 doc.save(getArtifactsDir() + "Field.SYMBOL.docx");
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | java.lang.String | The size in points of the font of the character retrieved by the field. |

### setLocaleId(int value) {#setLocaleId-int}
```
public void setLocaleId(int value)
```


Sets the LCID of the field.

 **Examples:** 

Shows how to insert a field and work with its locale.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Insert a DATE field, and then print the date it will display.
 // Your thread's current culture determines the formatting of the date.
 Field field = builder.insertField("DATE");
 System.out.println(MessageFormat.format("Today''s date, as displayed in the \"{0}\" culture: {1}", Locale.getDefault().getDisplayLanguage(), field.getResult()));

 Assert.assertEquals(1033, field.getLocaleId());
 // Changing the culture of our thread will impact the result of the DATE field.
 // Another way to get the DATE field to display a date in a different culture is to use its LocaleId property.
 // This way allows us to avoid changing the thread's culture to get this effect.
 doc.getFieldOptions().setFieldUpdateCultureSource(FieldUpdateCultureSource.FIELD_CODE);
 CultureInfo de = new CultureInfo("de-DE");
 field.setLocaleId(1031);
 field.update();

 System.out.println(MessageFormat.format("Today''s date, as displayed according to the \"{0}\" culture: {1}", Locale.forLanguageTag(LocaleUtil.getLocaleFromLCID(field.getLocaleId())).getDisplayLanguage(), field.getResult()));
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | int | The LCID of the field. |

### setResult(String value) {#setResult-java.lang.String}
```
public void setResult(String value)
```


Sets text that is between the field separator and field end.

 **Examples:** 

Shows how to insert a field into a document using a field code.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 Field dateField = builder.insertField("DATE \\* MERGEFORMAT");

 Assert.assertEquals(FieldType.FIELD_DATE, dateField.getType());
 Assert.assertEquals("DATE \\* MERGEFORMAT", dateField.getFieldCode());
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | java.lang.String | Text that is between the field separator and field end. |

### unlink() {#unlink}
```
public boolean unlink()
```


Performs the field unlink.

 **Remarks:** 

Replaces the field with its most recent result.

Some fields, such as XE (Index Entry) fields and SEQ (Sequence) fields, cannot be unlinked.

 **Examples:** 

Shows how to unlink a field.

```

 Document doc = new Document(getMyDir() + "Linked fields.docx");
 doc.getRange().getFields().get(1).unlink();
 
```

**Returns:**
boolean -  true  if the field has been unlinked, otherwise  false .
### update() {#update}
```
public void update()
```


Performs the field update. Throws if the field is being updated already.

 **Examples:** 

Shows how to insert a field into a document using FieldType.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Insert two fields while passing a flag which determines whether to update them as the builder inserts them.
 // In some cases, updating fields could be computationally expensive, and it may be a good idea to defer the update.
 doc.getBuiltInDocumentProperties().setAuthor("John Doe");
 builder.write("This document was written by ");
 builder.insertField(FieldType.FIELD_AUTHOR, updateInsertedFieldsImmediately);

 builder.insertParagraph();
 builder.write("\nThis is page ");
 builder.insertField(FieldType.FIELD_PAGE, updateInsertedFieldsImmediately);

 Assert.assertEquals(" AUTHOR ", doc.getRange().getFields().get(0).getFieldCode());
 Assert.assertEquals(" PAGE ", doc.getRange().getFields().get(1).getFieldCode());

 if (updateInsertedFieldsImmediately) {
     Assert.assertEquals("John Doe", doc.getRange().getFields().get(0).getResult());
     Assert.assertEquals("1", doc.getRange().getFields().get(1).getResult());
 } else {
     Assert.assertEquals("", doc.getRange().getFields().get(0).getResult());
     Assert.assertEquals("", doc.getRange().getFields().get(1).getResult());

     // We will need to update these fields using the update methods manually.
     doc.getRange().getFields().get(0).update();

     Assert.assertEquals("John Doe", doc.getRange().getFields().get(0).getResult());

     doc.updateFields();

     Assert.assertEquals("1", doc.getRange().getFields().get(1).getResult());
 }
 
```

Shows how to format field results.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 // Use a document builder to insert a field that displays a result with no format applied.
 Field field = builder.insertField("= 2 + 3");

 Assert.assertEquals("= 2 + 3", field.getFieldCode());
 Assert.assertEquals("5", field.getResult());

 // We can apply a format to a field's result using the field's properties.
 // Below are three types of formats that we can apply to a field's result.
 // 1 -  Numeric format:
 FieldFormat format = field.getFormat();
 format.setNumericFormat("$###.00");
 field.update();

 Assert.assertEquals("= 2 + 3 \\# $###.00", field.getFieldCode());
 Assert.assertEquals("$  5.00", field.getResult());

 // 2 -  Date/time format:
 field = builder.insertField("DATE");
 format = field.getFormat();
 format.setDateTimeFormat("dddd, MMMM dd, yyyy");
 field.update();

 Assert.assertEquals("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.getFieldCode());
 System.out.println("Today's date, in {format.DateTimeFormat} format:\n\t{field.Result}");

 // 3 -  General format:
 field = builder.insertField("= 25 + 33");
 format = field.getFormat();
 format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
 format.getGeneralFormats().add(GeneralFormat.UPPER);
 field.update();

 int index = 0;
 Iterator generalFormatEnumerator = format.getGeneralFormats().iterator();
 while (generalFormatEnumerator.hasNext()) {
     int value = generalFormatEnumerator.next();
     System.out.println(MessageFormat.format("General format index {0}: {1}", index++, value));
 }

 Assert.assertEquals("= 25 + 33 \\* roman \\* Upper", field.getFieldCode());
 Assert.assertEquals("LVIII", field.getResult());
 Assert.assertEquals(2, format.getGeneralFormats().getCount());
 Assert.assertEquals(GeneralFormat.LOWERCASE_ROMAN, format.getGeneralFormats().get(0));

 // We can remove our formats to revert the field's result to its original form.
 format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
 format.getGeneralFormats().removeAt(0);
 Assert.assertEquals(0, format.getGeneralFormats().getCount());
 field.update();

 Assert.assertEquals("= 25 + 33  ", field.getFieldCode());
 Assert.assertEquals("58", field.getResult());
 Assert.assertEquals(0, format.getGeneralFormats().getCount());
 
```

### update(boolean ignoreMergeFormat) {#update-boolean}
```
public void update(boolean ignoreMergeFormat)
```


Performs a field update. Throws if the field is being updated already.

 **Examples:** 

Shows how to preserve or discard INCLUDEPICTURE fields when loading a document.

```

 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);

 FieldIncludePicture includePicture = (FieldIncludePicture) builder.insertField(FieldType.FIELD_INCLUDE_PICTURE, true);
 includePicture.setSourceFullName(getImageDir() + "Transparent background logo.png");
 includePicture.update(true);

 try (ByteArrayOutputStream docStream = new ByteArrayOutputStream()) {
     doc.save(docStream, new OoxmlSaveOptions(SaveFormat.DOCX));

     // We can set a flag in a LoadOptions object to decide whether to convert all INCLUDEPICTURE fields
     // into image shapes when loading a document that contains them.
     LoadOptions loadOptions = new LoadOptions();
     {
         loadOptions.setPreserveIncludePictureField(preserveIncludePictureField);
     }

     doc = new Document(new ByteArrayInputStream(docStream.toByteArray()), loadOptions);
     FieldCollection fieldCollection = doc.getRange().getFields();

     if (preserveIncludePictureField) {
         Assert.assertTrue(IterableUtils.matchesAny(fieldCollection, f -> f.getType() == FieldType.FIELD_INCLUDE_PICTURE));

         doc.updateFields();
         doc.save(getArtifactsDir() + "Field.PreserveIncludePicture.docx");
     } else {
         Assert.assertFalse(IterableUtils.matchesAny(fieldCollection, f -> f.getType() == FieldType.FIELD_INCLUDE_PICTURE));
     }
 }
 
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| ignoreMergeFormat | boolean | If  true  then direct field result formatting is abandoned, regardless of the MERGEFORMAT switch, otherwise normal update is performed. |