IsBytes

IsBytes( value )
IsBytes( value )
IsBytes( value )
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.

Description

The IsBytes function returns true only if value is a sequence of one or more Bytes, otherwise it returns false.

Parameters

Argument Type Definition and Requirements

value

Any

Any value, which is to be tested to determine whether it is a sequence of one or more bytes or not.

Returns

Returns a boolean, indicating whether value was a sequence of one or more bytes or not.

Examples

The following query uses Map to iterate over an array of all of the types of values that can be tested by a type-check function, passing each item into a Lambda function that returns an object, which contains the value and the result of calling IsBytes with that value:

System.out.println(
    client.query(
        Map(
            Arr(
                Arr(Value("array")),
                Value(true),
                Value(false),
                Value(new byte[] {0x1, 0x2, 0x3, 0x4}),
                Arr(Value(0x1), Value(0x2), Value(0x3), Value(0x4)),
                Collection("Letters"),
                Ref("credentials/self"),
                Database("child_db"),
                Date("2019-11-12"),
                Ref(Collection("Letters"), "123"),
                Value(10.1),
                Function("double"),
                Index("all_letters"),
                Value(10),
                Ref(Keys(), "248967241620521472"),
                Query(Lambda("x", Var("x"))),
                Null(),
                Obj("x", Value(10)),
                Role("employees"),
                Match(Index("all_letters")),
                Value("ten"),
                Value("10"),
                Now(),
                Ref(Tokens(), "249062079147803136")
            ),
            Lambda(
                "x",
                Obj("value", Var("x"), "IsBytes", IsBytes(Var("x")))
            )
        )
    ).get());
client.query(
  q.Map(
    [
      ['array'],
      true,
      false,
      new Uint8Array([1, 2, 3, 4]),
      [0x1, 0x2, 0x3, 0x4],
      q.Collection('Letters'),
      q.Ref('credentials/self'),
      q.Database('child_db'),
      q.Date('2019-11-12'),
      q.Ref(q.Collection('Letters'), 123),
      10.1,
      q.Function('double'),
      q.Index('all_letters'),
      10,
      q.Ref(q.Keys(), '248967241620521472'),
      q.Query(q.Lambda('x', q.Var('x'))),
      null,
      { x: 10 },
      q.Role('employees'),
      q.Match(q.Index('all_letters')),
      'ten',
      '10',
      q.Now(),
      q.Ref(q.Tokens(), '249062079147803136'),
    ],
    q.Lambda('x', {
      value: q.Var('x'),
      IsBytes: q.IsBytes(q.Var('x')),
    })
  )
)
.then((ret) => console.log(ret))
println(Await.result(
  client.query(
    Map(
      Arr(
        Arr("array"),
        true,
        false,
        BytesV(0x1, 0x2, 0x3, 0x4),
        Arr(0x1, 0x2, 0x3, 0x4),
        Collection("Letters"),
        Ref("credentials/self"),
        Database("child_db"),
        Date("2019-11-12"),
        Ref(Collection("Letters"), 123),
        10.1,
        Function("double"),
        Index("all_letters"),
        10,
        Ref(Keys(), "248967241620521472"),
        Query(Lambda("x", Var("x"))),
        Null,
        Obj("x" -> 10),
        Role("employees"),
        Match(Index("all_letters")),
        "ten",
        "10",
        Now(),
        Ref(Tokens(), "249062079147803136")
      ),
      Lambda(
        "x",
        Obj( "value" -> Var("x"), "IsBytes" -> IsBytes(Var("x")))
      )
    )
  ),
  5.seconds
))
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.
Not available in this language yet.
[{value: ["array"], IsBytes: false},
 {value: true, IsBytes: false},
 {value: false, IsBytes: false},
 {value: [0x01 0x02 0x03 0x04], IsBytes: true},
 {value: [1, 2, 3, 4], IsBytes: false},
 {value: ref(id = "Letters", collection = ref(id = "collections")),
  IsBytes: false},
 {value: ref(id = "248967019900174848", collection = ref(id = "credentials")),
  IsBytes: false},
 {value: ref(id = "child_db", collection = ref(id = "databases")),
  IsBytes: false},
 {value: 2019-11-12, IsBytes: false},
 {value: ref(id = "123", collection = ref(id = "Letters", collection = ref(id = "collections"))),
  IsBytes: false},
 {value: 10.1, IsBytes: false},
 {value: ref(id = "double", collection = ref(id = "functions")),
  IsBytes: false},
 {value: ref(id = "all_letters", collection = ref(id = "indexes")),
  IsBytes: false},
 {value: 10, IsBytes: false},
 {value: ref(id = "248967241620521472", collection = ref(id = "keys")),
  IsBytes: false},
 {value: QueryV({lambda=x, expr={var=x}}), IsBytes: false},
 {value: null, IsBytes: false},
 {value: {x: 10}, IsBytes: false},
 {value: ref(id = "employees", collection = ref(id = "roles")),
  IsBytes: false},
 {value: {@set = {match: ref(id = "all_letters", collection = ref(id = "indexes"))}},
  IsBytes: false},
 {value: "ten", IsBytes: false},
 {value: "10", IsBytes: false},
 {value: 2019-11-12T13:15:16.789Z, IsBytes: false},
 {value: ref(id = "249062079147803136", collection = ref(id = "tokens")),
  IsBytes: false}]
[ { value: [ 'array' ], IsBytes: false },
  { value: true, IsBytes: false },
  { value: false, IsBytes: false },
  { value: Bytes("AQIDBA=="), IsBytes: true },
  { value: [ 1, 2, 3, 4 ], IsBytes: false },
  { value: Collection("Letters"), IsBytes: false },
  { value: Ref(Credentials(), "248967019900174848"),
    IsBytes: false },
  { value: Database("child_db"), IsBytes: false },
  { value: Date("2019-11-12"), IsBytes: false },
  { value: Ref(Collection("Letters"), "123"), IsBytes: false },
  { value: 10.1, IsBytes: false },
  { value: Function("double"), IsBytes: false },
  { value: Index("all_letters"), IsBytes: false },
  { value: 10, IsBytes: false },
  { value: Ref(Keys(), "248967241620521472"), IsBytes: false },
  { value: Query(Lambda("x", Var("x"))), IsBytes: false },
  { value: null, IsBytes: false },
  { value: { x: 10 }, IsBytes: false },
  { value: Role("employees"), IsBytes: false },
  { value: Match(Index("all_letters")), IsBytes: true },
  { value: 'ten', IsBytes: false },
  { value: '10', IsBytes: false },
  { value: Time("2019-11-12T13:15:16.789Z"), IsBytes: false },
  { value: Ref(Tokens(), "249062079147803136"), IsBytes: false } ]
[{value: ["array"], IsBytes: false},
 {value: true, IsBytes: false},
 {value: false, IsBytes: false},
 {value: [0x01 0x02 0x03 0x04], IsBytes: true},
 {value: [1, 2, 3, 4], IsBytes: false},
 {value: ref(id = "Letters", collection = ref(id = "collections")),
  IsBytes: false},
 {value: ref(id = "248967019900174848", collection = ref(id = "credentials")),
  IsBytes: false},
 {value: ref(id = "child_db", collection = ref(id = "databases")),
  IsBytes: false},
 {value: 2019-11-12, IsBytes: false},
 {value: ref(id = "123", collection = ref(id = "Letters", collection = ref(id = "collections"))),
  IsBytes: false},
 {value: 10.1, IsBytes: false},
 {value: ref(id = "double", collection = ref(id = "functions")),
  IsBytes: false},
 {value: ref(id = "all_letters", collection = ref(id = "indexes")),
  IsBytes: false},
 {value: 10, IsBytes: false},
 {value: ref(id = "248967241620521472", collection = ref(id = "keys")),
  IsBytes: false},
 {value: {lambda: "x", expr: {var: "x"}}, IsBytes: false},
 {value: NullV, IsBytes: false},
 {value: {x: 10}, IsBytes: false},
 {value: ref(id = "employees", collection = ref(id = "roles")),
  IsBytes: false},
 {value: {@set = {match: ref(id = "all_letters", collection = ref(id = "indexes"))}},
  IsBytes: false},
 {value: "ten", IsBytes: false},
 {value: "10", IsBytes: false},
 {value: 2019-11-12T13:15:16.789Z, IsBytes: false},
 {value: ref(id = "249062079147803136", collection = ref(id = "tokens")),
  IsBytes: false}]

This query operates on a pre-existing schema, which is not provided here.

Also, the query is executed via a client connection, that uses a secret acquired by calling Login (not shown here), so that Ref("credentials/self") returns a valid value.

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve! documentation@fauna.com

Thank you for your feedback!