NTriplesUtil (RDF4J: Storage 2.3.0 API)

java.lang.Object
- org.eclipse.rdf4j.rio.ntriples.NTriplesUtil

```
public class NTriplesUtil
extends Object
```
Utility methods for N-Triples encoding/decoding.

Constructor Summary

Constructors
Constructor and Description

NTriplesUtil()

Constructors
Constructor and Description
`NTriplesUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`append(BNode bNode, Appendable appendable)`
`static void`	`append(IRI uri, Appendable appendable)`
`static void`	`append(Literal lit, Appendable appendable)`
`static void`	`append(Literal lit, Appendable appendable, boolean xsdStringToPlainLiteral)` Appends the N-Triples representation of the given `Literal` to the given `Appendable`, optionally ignoring the xsd:string datatype as it is implied for RDF-1.1.
`static void`	`append(Resource resource, Appendable appendable)`
`static void`	`append(Value value, Appendable appendable)`
`static void`	`append(Value value, Appendable appendable, boolean xsdStringToPlainLiteral, boolean escapeUnicode)` Appends the N-Triples representation of the given `Value` to the given `Appendable`, optionally not serialising the datatype a `Literal` with the xsd:string datatype as it is implied for RDF-1.1.
`static String`	`escapeString(String label)` Escapes a Unicode string to an all-ASCII character sequence.
`static void`	`escapeString(String label, Appendable appendable)` Escapes a Unicode string to an all-ASCII character sequence.
`static void`	`escapeString(String label, Appendable appendable, boolean escapeUnicode)` Escapes a Unicode string to an N-Triples compatible character sequence.
`static boolean`	`isLetter(int c)` Checks whether the supplied character is a letter according to the N-Triples specification.
`static boolean`	`isLetterOrNumber(int c)` Checks whether the supplied character is a letter or number according to the N-Triples specification.
`static boolean`	`isNumber(int c)` Checks whether the supplied character is a number according to the N-Triples specification.
`static BNode`	`parseBNode(String nTriplesBNode, ValueFactory valueFactory)` Parses an N-Triples bNode, creates an object for it using the supplied ValueFactory and returns this object.
`static Literal`	`parseLiteral(String nTriplesLiteral, ValueFactory valueFactory)` Parses an N-Triples literal, creates an object for it using the supplied ValueFactory and returns this object.
`static Resource`	`parseResource(String nTriplesResource, ValueFactory valueFactory)` Parses an N-Triples resource, creates an object for it using the supplied ValueFactory and returns this object.
`static IRI`	`parseURI(String nTriplesURI, ValueFactory valueFactory)` Parses an N-Triples URI, creates an object for it using the supplied ValueFactory and returns this object.
`static Value`	`parseValue(String nTriplesValue, ValueFactory valueFactory)` Parses an N-Triples value, creates an object for it using the supplied ValueFactory and returns this object.
`static String`	`toHexString(int decimal, int stringLength)` Converts a decimal value to a hexadecimal string represention of the specified length.
`static String`	`toNTriplesString(BNode bNode)` Creates an N-Triples string for the supplied bNode.
`static String`	`toNTriplesString(IRI uri)` Creates an N-Triples string for the supplied URI.
`static String`	`toNTriplesString(Literal lit)` Creates an N-Triples string for the supplied literal.
`static String`	`toNTriplesString(Literal lit, boolean xsdStringToPlainLiteral)` Creates an N-Triples string for the supplied literal, optionally ignoring the xsd:string datatype as it is implied for RDF-1.1.
`static String`	`toNTriplesString(Resource resource)` Creates an N-Triples string for the supplied resource.
`static String`	`toNTriplesString(Value value)` Creates an N-Triples string for the supplied value.
`static String`	`toNTriplesString(Value value, boolean xsdStringToPlainLiteral)` Creates an N-Triples string for the supplied value.
`static String`	`unescapeString(String s)` Unescapes an escaped Unicode string.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - NTriplesUtil
```
public NTriplesUtil()
```
- Method Detail
  - parseValue
```
public static Value parseValue(String nTriplesValue,
                               ValueFactory valueFactory)
                        throws IllegalArgumentException
```
    Parses an N-Triples value, creates an object for it using the supplied ValueFactory and returns this object.
    
    Parameters:
    
    nTriplesValue - The N-Triples value to parse.
    
    valueFactory - The ValueFactory to use for creating the object.
    
    Returns:
    
    An object representing the parsed value.
    
    Throws:
    
    IllegalArgumentException - If the supplied value could not be parsed correctly.
  - parseResource
```
public static Resource parseResource(String nTriplesResource,
                                     ValueFactory valueFactory)
                              throws IllegalArgumentException
```
    Parses an N-Triples resource, creates an object for it using the supplied ValueFactory and returns this object.
    
    Parameters:
    
    nTriplesResource - The N-Triples resource to parse.
    
    valueFactory - The ValueFactory to use for creating the object.
    
    Returns:
    
    An object representing the parsed resource.
    
    Throws:
    
    IllegalArgumentException - If the supplied resource could not be parsed correctly.
  - parseURI
```
public static IRI parseURI(String nTriplesURI,
                           ValueFactory valueFactory)
                    throws IllegalArgumentException
```
    Parses an N-Triples URI, creates an object for it using the supplied ValueFactory and returns this object.
    
    Parameters:
    
    nTriplesURI - The N-Triples URI to parse.
    
    valueFactory - The ValueFactory to use for creating the object.
    
    Returns:
    
    An object representing the parsed URI.
    
    Throws:
    
    IllegalArgumentException - If the supplied URI could not be parsed correctly.
  - parseBNode
```
public static BNode parseBNode(String nTriplesBNode,
                               ValueFactory valueFactory)
                        throws IllegalArgumentException
```
    Parses an N-Triples bNode, creates an object for it using the supplied ValueFactory and returns this object.
    
    Parameters:
    
    nTriplesBNode - The N-Triples bNode to parse.
    
    valueFactory - The ValueFactory to use for creating the object.
    
    Returns:
    
    An object representing the parsed bNode.
    
    Throws:
    
    IllegalArgumentException - If the supplied bNode could not be parsed correctly.
  - parseLiteral
```
public static Literal parseLiteral(String nTriplesLiteral,
                                   ValueFactory valueFactory)
                            throws IllegalArgumentException
```
    Parses an N-Triples literal, creates an object for it using the supplied ValueFactory and returns this object.
    
    Parameters:
    
    nTriplesLiteral - The N-Triples literal to parse.
    
    valueFactory - The ValueFactory to use for creating the object.
    
    Returns:
    
    An object representing the parsed literal.
    
    Throws:
    
    IllegalArgumentException - If the supplied literal could not be parsed correctly.
  - toNTriplesString
```
public static String toNTriplesString(Value value)
```
    Creates an N-Triples string for the supplied value.
  - toNTriplesString
```
public static String toNTriplesString(Value value,
                                      boolean xsdStringToPlainLiteral)
```
    Creates an N-Triples string for the supplied value. If the supplied value is a Literal, it optionally ignores the xsd:string datatype, since this datatype is implicit in RDF-1.1.
    
    Parameters:
    
    value - The value to write.
    
    xsdStringToPlainLiteral - True to omit serialising the xsd:string datatype and false to always serialise the datatype for literals.
  - append
```
public static void append(Value value,
                          Appendable appendable)
                   throws IOException
```
    Throws:
    
    IOException
  - append
```
public static void append(Value value,
                          Appendable appendable,
                          boolean xsdStringToPlainLiteral,
                          boolean escapeUnicode)
                   throws IOException
```
    Appends the N-Triples representation of the given Value to the given Appendable, optionally not serialising the datatype a Literal with the xsd:string datatype as it is implied for RDF-1.1.
    
    Parameters:
    
    value - The value to write.
    
    appendable - The object to append to.
    
    xsdStringToPlainLiteral - True to omit serialising the xsd:string datatype and false to always serialise the datatype for literals.
    
    Throws:
    
    IOException
  - toNTriplesString
```
public static String toNTriplesString(Resource resource)
```
    Creates an N-Triples string for the supplied resource.
  - append
```
public static void append(Resource resource,
                          Appendable appendable)
                   throws IOException
```
    Throws:
    
    IOException
  - toNTriplesString
```
public static String toNTriplesString(IRI uri)
```
    Creates an N-Triples string for the supplied URI.
  - append
```
public static void append(IRI uri,
                          Appendable appendable)
                   throws IOException
```
    Throws:
    
    IOException
  - toNTriplesString
```
public static String toNTriplesString(BNode bNode)
```
    Creates an N-Triples string for the supplied bNode.
  - append
```
public static void append(BNode bNode,
                          Appendable appendable)
                   throws IOException
```
    Throws:
    
    IOException
  - toNTriplesString
```
public static String toNTriplesString(Literal lit)
```
    Creates an N-Triples string for the supplied literal.
  - toNTriplesString
```
public static String toNTriplesString(Literal lit,
                                      boolean xsdStringToPlainLiteral)
```
    Creates an N-Triples string for the supplied literal, optionally ignoring the xsd:string datatype as it is implied for RDF-1.1.
    
    Parameters:
    
    lit - The literal to write.
    
    xsdStringToPlainLiteral - True to omit serialising the xsd:string datatype and false to always serialise the datatype for literals.
  - append
```
public static void append(Literal lit,
                          Appendable appendable)
                   throws IOException
```
    Throws:
    
    IOException
  - append
```
public static void append(Literal lit,
                          Appendable appendable,
                          boolean xsdStringToPlainLiteral)
                   throws IOException
```
    Appends the N-Triples representation of the given Literal to the given Appendable, optionally ignoring the xsd:string datatype as it is implied for RDF-1.1.
    
    Parameters:
    
    lit - The literal to write.
    
    appendable - The object to append to.
    
    xsdStringToPlainLiteral - True to omit serialising the xsd:string datatype and false to always serialise the datatype for literals.
    
    Throws:
    
    IOException
  - isLetterOrNumber
```
public static boolean isLetterOrNumber(int c)
```
    Checks whether the supplied character is a letter or number according to the N-Triples specification.
    
    See Also:
    
    isLetter(int), isNumber(int)
  - isLetter
```
public static boolean isLetter(int c)
```
    Checks whether the supplied character is a letter according to the N-Triples specification. N-Triples letters are A - Z and a - z.
  - isNumber
```
public static boolean isNumber(int c)
```
    Checks whether the supplied character is a number according to the N-Triples specification. N-Triples numbers are 0 - 9.
  - escapeString
```
public static String escapeString(String label)
```
    Escapes a Unicode string to an all-ASCII character sequence. Any special characters are escaped using backslashes (" becomes \", etc.), and non-ascii/non-printable characters are escaped using Unicode escapes (\uxxxx and \Uxxxxxxxx).
  - escapeString
```
public static void escapeString(String label,
                                Appendable appendable)
                         throws IOException
```
    Escapes a Unicode string to an all-ASCII character sequence. Any special characters are escaped using backslashes (" becomes \", etc.), and non-ascii/non-printable characters are escaped using Unicode escapes (\uxxxx and \Uxxxxxxxx).
    
    Throws:
    
    IOException
  - escapeString
```
public static void escapeString(String label,
                                Appendable appendable,
                                boolean escapeUnicode)
                         throws IOException
```
    Escapes a Unicode string to an N-Triples compatible character sequence. Any special characters are escaped using backslashes (" becomes \", etc.), and non-ascii/non-printable characters are escaped using Unicode escapes (\uxxxx and \Uxxxxxxxx) if the option is selected.
    
    Throws:
    
    IOException
  - unescapeString
```
public static String unescapeString(String s)
```
    Unescapes an escaped Unicode string. Any Unicode sequences ( \uxxxx and \Uxxxxxxxx) are restored to the value indicated by the hexadecimal argument and any backslash-escapes ( \", \\, etc.) are decoded to their original form.
    
    Parameters:
    
    s - An escaped Unicode string.
    
    Returns:
    
    The unescaped string.
    
    Throws:
    
    IllegalArgumentException - If the supplied string is not a correctly escaped N-Triples string.
  - toHexString
```
public static String toHexString(int decimal,
                                 int stringLength)
```
    Converts a decimal value to a hexadecimal string represention of the specified length.
    
    Parameters:
    
    decimal - A decimal value.
    
    stringLength - The length of the resulting string.

Class NTriplesUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

NTriplesUtil

Method Detail

parseValue

parseResource

parseURI

parseBNode

parseLiteral

toNTriplesString

toNTriplesString

append

append

toNTriplesString

append

toNTriplesString

append

toNTriplesString

append

toNTriplesString

toNTriplesString

append

append

isLetterOrNumber

isLetter

isNumber

escapeString

escapeString

escapeString

unescapeString

toHexString