From dev-return-166176-archive-asf-public=cust-asf.ponee.io@commons.apache.org Thu Feb 1 18:42:10 2018 Return-Path: X-Original-To: archive-asf-public@eu.ponee.io Delivered-To: archive-asf-public@eu.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by mx-eu-01.ponee.io (Postfix) with ESMTP id 59B8D180652 for ; Thu, 1 Feb 2018 18:42:10 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 49514160C44; Thu, 1 Feb 2018 17:42:10 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 90561160C35 for ; Thu, 1 Feb 2018 18:42:09 +0100 (CET) Received: (qmail 62888 invoked by uid 500); 1 Feb 2018 17:42:08 -0000 Mailing-List: contact dev-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Commons Developers List" Delivered-To: mailing list dev@commons.apache.org Received: (qmail 62875 invoked by uid 99); 1 Feb 2018 17:42:07 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd4-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Feb 2018 17:42:07 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd4-us-west.apache.org (ASF Mail Server at spamd4-us-west.apache.org) with ESMTP id 6219DC0572 for ; Thu, 1 Feb 2018 17:42:07 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd4-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 1.879 X-Spam-Level: * X-Spam-Status: No, score=1.879 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=2, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001] autolearn=disabled Authentication-Results: spamd4-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd4-us-west.apache.org [10.40.0.11]) (amavisd-new, port 10024) with ESMTP id gwESzK6T38AN for ; Thu, 1 Feb 2018 17:42:06 +0000 (UTC) Received: from mail-oi0-f54.google.com (mail-oi0-f54.google.com [209.85.218.54]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTPS id C71F35F4E4 for ; Thu, 1 Feb 2018 17:42:05 +0000 (UTC) Received: by mail-oi0-f54.google.com with SMTP id 4so13972308ois.10 for ; Thu, 01 Feb 2018 09:42:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to; bh=syEalGJJ4BdSybTQJEmI5lhTCETl/9B0noVntQwiccs=; b=gU/Hu07Sm2pR/SEokj+8eQTe0nmHoLbdfKSjTO3oDDBI05pjT688R0Iu3ndHpvMCI/ L/2lEVa1IN5B5sBp/SMG95cPsUN0+xNoo3A8bNnzvXU/9WgIioV0RWi/4WPq5ZjyqFEW ZijQFF7ZD10pan0Um4s/gUevKN3ultm7S2TF4HlUL46W9Veu4rCe3hr/FmFzNzDtNOd3 4UM9ToOHP46cDlQfCjeUZwQ2Hweot67XjZ1SIEuAfcKBa6jpqsy4F/W/yE5qsl9RZ0mG 3y0AYwoq2prh8squYVdsliuaCYQFvO3ETb1Z29QwL/bBFD3ZDbAO9Pg5yzLEJBTq76+r xMBg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to; bh=syEalGJJ4BdSybTQJEmI5lhTCETl/9B0noVntQwiccs=; b=BmyCHbCqJhWimHu+rTXUgxjikZ1pbmTfGWfWtuOPNb4STQItTOg2UFghu/+496kkHo aF4uBueCAWCNgRm3b6X286OGcVqlzGPvMb+SeEnHt9Wy0qabtbcgdci43+laSq1N2p9R XX82UbSnPXXBH55go8pP7+7N/fxJFCwtvl/V96xAWt2ONASdhx+632T5JIku0TJFz21i LNzrU+kTpeYt6i25LnKedoD8R3x3dhbGul27yo+hT4B3PHgS+Dhzdxekfoc1cXG5RZoj ny4UA87U2Gzz/q0lKIM4Pc/456Hjb17EKyICyn0s/T/oMJSibjWIkktlb28ReFgxwuKk uFZA== X-Gm-Message-State: AKwxytdUtuLW3yKFSkUiu/o4Bqx+xEhDXjKnL4I1qfqwX81rwkjF5Isy FczPpqC0894lk7yH2aK4CTdL8bUTtkQCVnF2U8Zi X-Google-Smtp-Source: AH8x225fraBV4z74LnBfY/pB5QCINvIkI7nUrbETf4XTxUGG//HbUT0B7U4anSLNuIRMIX7r4PD7aXMtFOkYz6LjSqs= X-Received: by 10.202.81.15 with SMTP id f15mr9704109oib.332.1517506919354; Thu, 01 Feb 2018 09:41:59 -0800 (PST) MIME-Version: 1.0 Received: by 10.157.16.124 with HTTP; Thu, 1 Feb 2018 09:41:58 -0800 (PST) In-Reply-To: References: <80544219ff2948abee5bbc97ebce4e49@scarlet.be> From: Gary Gregory Date: Thu, 1 Feb 2018 10:41:58 -0700 Message-ID: Subject: Re: [Numbers] API of "Complex" To: Commons Developers List Content-Type: multipart/alternative; boundary="001a113d7ae2df5c2c05642a1c03" --001a113d7ae2df5c2c05642a1c03 Content-Type: text/plain; charset="UTF-8" On Thu, Feb 1, 2018 at 9:59 AM, Stephen Colebourne wrote: > On 1 February 2018 at 15:30, Gary Gregory wrote: > > For example, (picking a made up example) this reads really well to me: > > Pair.of(foo, bar) because that what you'd use in spoken English. > > > > OTOH, this does not read well to me: Fraction.of(num, denum); this would > be > > better: Fraction.from(num, denum) > > In JSR-310, of() is used when there is little work performed in the > factory, and relatively low chance of an error. from() is used when > performing a complex conversion, that has a higher chance of failure, > I like that. To me from() implies some sort of conversion, and of() a simple construction. > > Stephen > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org > For additional commands, e-mail: dev-help@commons.apache.org > > --001a113d7ae2df5c2c05642a1c03--